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NOTICE 
THIS MANUAL CONTAINS REFEREN CES TO THE PERKIN- 
ELMER MODEL 3280 SYSTEM. HOWEVER, THE MODEL 3280 


SYSTEM WAS NOT AVAILABLE FOR THE OS/32 8.1 
SOFTWARE RELEASE. 


FOR FURTHER INFORMATION OR ASSISTANCE 
CONCERNING THE MODEL 3280 SYSTEM, PLEASE 
CONTACT YOUR LOCAL PERKIN-ELMER SALES 
REPRESENTATIVE. 
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CHAPTERS (Continued) 


PREFACE 


This manual is intended for system administrators and operators 
of an OS/32 Multi-Terminal Monitor (MTM) System. It provides 
step-by-step procedures for installing and operating an MTM 
system that is tailored to meet the needs of a particular 
Organization. 


Chapter 1 describes MTM and lists the system requirements’ and 
basic steps in configuring an MTM system. It also lists the 
recommended O0S/32 system generation (sysgen) options that improve 
MTM efficiency. Chapter 2 outlines the MTM sysgen procedure and 
defines the MTM sysgen procedure options. Chapter 3 describes 
building, loading and starting the Authorized User Utility, and 
lists the Authorized User Utility commands. Chapter 4 discusses 
the OS/32 Accounting Facility option. Chapter 5 describes the 
operating procedures needed to load, start and control the MTM. 
Chapter 6 introduces the load-leveling executive (LLE) software 
and describes its use in enhancing MTM performance in a Model 
3200MPS System multiprocessing environment. Appendix A 
summarizes the MTM sysgen options. Appendix B summarizes the 
Authorized User Utility commands. Appendix C lists the 
Authorized User Utility messages. Appendix D contains’ the 
accounting transaction file (ATF) record formats. Appendix E 
lists the MTM operator commands. 


The FO1l update of this manual reflects the changes required for 
the OS/32 features of RQ8.1. The Control/Diagnostic System 
(CDS), for the Model 3280, has been added as an MTM_ system 
requirement as an alternative to the loader storage unit (LSU) 
for loading the operating system. The multiperipheral controller 
(MPC) universal clock (UCLOCK) has been added as an alternative 
to the UCLOCK module. The MTMPARMS.MAC file has been revised to 
include the SGN.ASST option. The recommended quesize option size 
has been changed in the MTMPARMS.MAC file. Information pertinent 
to account 255 access has been added to the PRIVILEGE command. 
The .MTM PSM command has been moved from Chapter 6 to Chapter 5. 
The LLE information has been revised. 


This manual is intended for use with the OS/32 R08.1 software 
release and higher. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1.1 INTRODUCTION 


The OS/32 Multi-Terminal Monitor (MTM) is an interactive 
multi-terminal, time-sharing system that executes as an executive 
task (e-task) in an 0OS/32 environment. MTM can be loaded, 
started and cancelled without disrupting the execution of other 
tasks running concurrently under OS/32. All tasks loaded and 
started from a user terminal execute as subtasks of MTM. Figure 


1-1 shows the relationship of application tasks to OS/32 and MTM 
in a typical MIM system environment. 


6429 
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MTM TASK 


APPLICATION 


APPLICATION 
TASK 


APPLICATION 


TASK TASK 


OS/32 


FILE SYSTEM 


Figure 1-1 MTM System Environment 
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1.2 MULTI~TERMINAL MONITOR (MTM) SYSTEM REQUIREMENTS 

The minimum hardware and software requirements for configuring an 
MTM system are: 

@ OS/32 R08.1 software release 

e Perkin-Elmer Series 3200 Processor 


@ Memory access controller (MAC) or memory address’ translator 
(MAT), as appropriate 


e Universal clock (UCLOCK) module or multiperipheral controller 
(MPC) UCLOCK. 


e Power fail/auto-restart option 

e Console device 

e Relocating (REL) loader, bootloader, loader storage unit (LSU) 
or the Control/Diagnostic System (CDS) to load the operating 
system. 

@ 256kb of memory (288kb or greater is recommended) 


e Disk device 


e ASCII terminal device 


1.3 CONFIGURING A MULTI-TERMINAL MONITOR (MTM) SYSTEM 

The following procedure is used to configure an MTM system. 

1. Perform an OS/32 system generation (sysgen). See the 08/32 
System Generation/32 (Sysgen/32) Reference Manual. 


2. Unpack the MTM software. See the MTM packaging document for 
instructions. 


3. Perform an MTM sysgen, modifying the MTM sysgen options to 
reflect installation requirements. See Chapter 2 for more 
information. : 


4. Build an authorized user file (AUF) using the Authorized User. 
Utility described in Chapter 3. 


5. Load and start MTM. See Chapter 5 for more information. 
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1.4 OS/32 SYSTEM GENERATION (SYSGEN) OPTIONS 


When generating an operating system for an MTM system, select the 
following sysgen options to improve the overall efficiency and 
effectiveness of the system. 


@e Secondary directory support - adds a memory-resident directory 
to the system to reduce file search time. 


e Segmentation support - allows the task image to be segmented 
into a private image area containing impure code and a shared 
image area containing pure code. During multiple simultaneous 
executions of the task, a copy of the private image is loaded 
into memory for each user, but only one copy of the shared 
image is loaded. 


@e Roll support - ensures that MTM can service a number of tasks 
in a limited amount of memory space. 


@ Spool support - provides input and output spooling 
capabilities to the MTM user. 


e Accounting support - is required if the 0OS/32 Accounting 
Facility is to be used with MTM (see Chapter 4). 

1.5 FILE DESCRIPTORS 

Many of the command formats in this manual require the user to 


enter a file descriptor (fd). File descriptors are entered in 
the following format. 


Format: 


Lace Joes Goede sel 


Parameters: 


voln: is a l- to 4-character disk volume name. The 
first character must be alphabetic and the 
remaining alphanumeric. If voln: is not 


specified, the default volume specified by the 
VOLUME command is used. 
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dev: 


f ilename 


-ext 


actno 


file class 


is a l- to 4-character device name. The first 
character must be alphabetic and the remaining 
alphanumeric. 


is a l- to 8-character name of a file. The 
first character must be alphabetic and the 
remaining alphanumeric. If a filename is 


specified when a device mnemonic is specified 
as voln:, the filename is ignored. 


is the name of the extension and consists of 
from 1- to 3-alphanumeric characters. For 
some commands, extensions are appended by 
default. If the period is omitted, the 
default is blanks. 


is a decimal number ranging from 0 to 65,535 
that specifies the account number associated 
with the file. Account numbers 1 through 
65,535 are used by MTM. Account number 255 is 
a restricted account. MTM uses account 255 
for the AUF. Account number O is used for 
system files and is the default for all 
operator commands entered from the system 
console. Tasks must have account privileges 
to specify an account number in this field. 


is the class name of the file and consists of 
one character. The class names are: 

e /P for private file 

e /G for group file 

e /S for system file 

The file class can be specified by a terminal 
user or the system operator. If the system 


operator specifies /P, /G or /S, the operation 
is performed to account O only. 
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CHAPTER 2 
MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 


2.1 INTRODUCTION 


This chapter describes MTM sysgen procedures and options 
available for configuring an MTM system. 


The MTM task consists of two modules: 


e@ MTMMAIN 

e@ MTMSGN 

MTMMAIN is a fixed length object file containing the executable 
code for MTM. 


MTMSGN is a source file containing the MTM sysgen options. These 
options can be modified to meet installation requirements. 


The procedure for performing an MTM sysgen is as follows: 

e Select the MTM_ sysgen options that pertain to the 
installation. 

e Use the command substitution system (CSS) command file 


(MTMSGN.CSS) to build the MTM task. 


The following sections describe the MTM sysgen procedure in 
detail. 


2.2 SELECTING MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION 
(SYSGEN) OPTIONS 


MTMSGN is a source module that contains the information necessary 
to configure an MTM system that meets the requirements of a 


particular installation. For example, one data field in this 
file tells MTM how many users can be signed on to the system 
concurrently. Another data field tells MTM how many command 


buffers to reserve in memory. See Section 2.4 for a _ complete 
description of the sysgen options contained in this file. 
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Perkin-Elmer supplies a standard MTM sysgen parameter file 
(MTMPARMS.MAC) with the MTM package. This file contains the 
following code: 


**MTM.SGN 

SPACE 2 

VERSION 

SPACE 2 
SGN.ACT EQU 0 NO ACCOUNTING SUPPORT 
SGN.SCHR EQU 1 O=NONE / 1=DYNAMIC / 2=PSM 
SGN. ROLL EQU 1 FORCE TASK ROLLABLE 
SGN.PRIO EQU 6 BATCH PRIORITY 
SGN.BTCP EQU 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 0 NO SPL/32 SUPPORT 
SGN. SHSP EQU 0 NO SHASP INTERFACE SUPPORT 
SGN.MVOL EQU Cc! . NO DEFAULT USER VOLUME 
SGN.ASST EQU a NUMBER OF MTMASST'S 
SGN.VAR EQU 28 NUMBER OF VARIABLES 
SGN. @GLO EQU 15 NUMBER OF GLOBAL VARIABLES 
SGN. @INT EQU 8 NUMBER OF INTERNAL VARIABLES 
NUSERS EQU 4 NUMBER OF USERS 
NCSSLVS EQU 8 NUMBER OF CSS LEVELS 
NCSBFS EQU 10 NUMBER OF EXTRA COMMAND BUFFERS 
NCONBFS EQU 0 NUMBER OF CONSOLE BUFFERS 
NSECTS EQU NUSERS/2 NUMBER OF SECTOR BUFFERS 
NMSGS EQU NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU NUSERS*3 SIZE OF TASK QUEUE 
CSBFSZ EQU 80 SIZE OF CSS BUFFERS 
CONBFSZ EQU 0 SIZE OF CONSOLE BUFFERS 
CDBUFSIZ EQU 3 SIZE OF SECTOR BUFFERS 
PRCLIMIT EQU 0 NO PROCESSOR TIME LIMIT 

SPACE 2 

LINKOPT 4,30 LINK OPTIONS IOB, LU 


In addition, MTMSGN defines values for the prompt sequence, the 
input/output (I/O) class table, user I/O limits and user 
processor time limits. See the IOTAB, UIOLIM, UPRCLIM, PRMTSEQ 
and PRMTDEV macro instructions in Section 2.4 for more 
information on the default values for these sysgen options. 


MTM sysgen options that differ from those defined by the standard 
MTM sysgen parameter file (MTMPARMS.MAC) can be selected by 
editing MTMPARMS.MAC via EDIT/32. 


In the following example, MTMPARMS.MAC is edited to permit five 
accounting classes, SPL/32 and HASP support, assignment of a user 
default volume, use of three MTMASST tasks, 25 concurrent users, 
a quesize of 75 slots, larger CSS buffers and an increased number 
of I/O blocks and logical units. In addition, several macro 
calls have been appended to MTMPARMS.MAC. Discussion of these 
macro calls is deferred until their respective sections in this 
chapter. Identification name '3230-B System' is assigned to this 
MTM system. 
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**MTM.SGN 


SPACE 2 

VERSION '3230-B SYSTEM' 

SPACE 2 | 
SGN.ACT EQU 5 5 ACCOUNTING CLASSES 
SGN.SCHR EQU- 1 O=NONE / 1=DYNAMIC / 2=PSM 
SGN.ROLL EQU. 1 FORCE TASK ROLLABLE 
SGN.PRIO EQU. 6 BATCH PRIORITY 
SGN.BTCP EQU. 0 CANCEL BATCH JOB ON PAUSE 
SGN.SPL EQU 25 SPL/32 SUPPORT - 25 BUFFERS 
SGN.S$HSP EQU. 1 1 SHASP INTERFACE 
SGN.MVOL EQU  C'MTM ' DEFAULT USER VOLUME - MTM 
SGN.ASST EQU 3 NUMBER OF MTMASST'S 
SGN.VAR EQU- 28 NUMBER OF VARIABLES 
SGN.@GLO EQU- 15 NUMBER OF GLOBAL VARIABLES 
SGN.@INT EQU- 8 NUMBER OF INTERNAL VARIABLES 


NUSERS EQU 
NCSSLVS EQU 
NCSBFS EQU 10 


NUMBER OF USERS 
NUMBER OF CSS LEVELS 
NUMBER OF EXTRA COMMAND BUFFERS 


foo WS) 
1S) 


NCONBFS EQU 0 NUMBER OF CONSOLE BUFFERS 
NSECTS EQU NUSERS/2 NUMBER OF SECTOR BUFFERS 

NMSGS EQU NUSERS NUMBER OF MESSAGE BUFFERS 
QUESIZE EQU NUSERS*3 SIZE OF TASK QUEUE 


CSBFSZ EQU 120 
CONBFSZ FQU 0 
CDBUFSIZ EQU 3 
PRCLIMIT EQU 0 
SPACE 2 
LINKOPT 25,80 
SPACE 2 . 
IOTAB (0,INDX), (1,CNTG), (2,DEV) ,(3,SPL), (4,TAPE) 
SPACE 2 
UPRCLIM 30,30,,,40,3600,80,10800 
SPACE 2 
UIOLIM (00,01,02,03,04) ,(100,101,102,103,104), 


SIZE OF CSS BUFFERS 
SIZE OF CONSOLE BUFFERS 
SIZE OF SECTOR BUFFERS 
NO PROCESSOR TIME LIMIT 


LINK OPTIONS IOB, LU 


(10,11,12,13,14),, U CLS 1l * 
(20,21,22,23,24), (120,121,122,123,124), U CLS 2 * 
(30,31,32,33,34) , (130,131,132,133,134) U CLS 3 

SPACE 2 . 

PRMTDEV (FOX,CT30,CT32,CT34), * 
(SIGMA, SM50) 

SPACE 2 

PRMTSEQ (FOX, (*,O8FF), (-,O8FF),(>,FF),(BUILD>,FF)), * 
(SIGMA) 


It is recommended that the MTM sysgen parameter file that results 
from editing MTMPARMS.MAC be saved with a different extension. 
For example, MTMPARMS.MAC can be edited as above, with the new 
file saved as MTMPARMS.xxx where xxx is a 1- to 3-character 
alphanumeric extension. For a further explanation of the 
subsequent use of this extension, see Section 2.3. 
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See the O0S/32 EDIT User Guide for information on editing files. 


NOTE 


The macro names VERSION, LINKOPT, IOTAB, 
UPRCLIM, PRMTDEV and PRMTSEQ must begin 
in column 10. 


2.3 GENERATING A MULTI-TERMINAL MONITOR (MTM) SYSTEM USING THE 
STANDARD COMMAND SUBSTITUTION SYSTEM (CSS) COMMAND FILE 
(MTMSGN. CSS) 


Perkin-Elmer supplies a CSS command file (MTMSGN.CSS) with the 
MTM package. MTMSGN.CSS assigns the SYSSTRUC. MLB and 
MTMSTRUC.MLB macro libraries. Therefore, MTMSGN.CSS may have’ to 
be edited via EDIT/32 to reflect the location of this file for a 
particular installation. For example, a volume and/or account 
classification (i.e., /P, /G, /S) may have to be specified for 
macro libraries. To call the standard CSS command file, enter 
the command as follows: 


Formats: 


XXX 
MTMSGN 
MAC 


Parameters: 


XXX is a l- to 3-character alphanumeric field that 
must be preceded by a space and must match the 
extension specified for the MTM sysgen 
parameter file (MTMPARMS). 


Functional Details: 


If the edited MTM sysgen parameter file was not saved with an 
extension Gifferent from that of the standard MTM _ sysgen 
parameter file or if the standard file is being used, MAC must be 
specified. 


Successful execution of MTMSGN.CSS returns end of task (EOT) 
code 0 upon completion of the MACRO/32 and CAL/32 processing 
phases. Upon successful completion of the link phase of 
MTMSGN.CSS, end of task (EOT) code 1 is returned after the 
following message: 


*** WARNING: ABSOLUTE SPACE LESS THAN 100 *** 
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The files created are a source listing MTMMAC.LST and a task 
MTMMAC.TSK. When a link error or assembly error (CAL/32) has 
occurred, see the source listing MTMMAC.LST. When a macro error 
(MACRO/32) has occurred, see-macro expansion MTMMAC.EXP. If an 
extention was specified, see MTMxxx.LST, etc. 


2.4 MULTI-TERMINAL MONITOR (MTM) SYSTEM GENERATION (SYSGEN) 
OPTIONS 


The MTM sysgen options are: | 


e CDBUFSIZ 


Sector buffer size 


@e CONBFSZ - Special console buffer size 

e CSBFSZ - Command buffer size 

@ IOTAB - I/O class table 

e LINKOPT - Number of I/O blocks and logical units for the Link 
OPTION command | 

@e NCONBFS - Number of special console buffers 

e NCSBFS ~ Number of command buffers 

@ NCSSLVS - Number of CSS levels 

e NMSGS - Number of message buffers 

e NSECTS - Number of sector length buffers 

@e NUSERS - Number of concurrent users 


® PRCLIMIT - Batch job processor time limit 


@e PRMTDEV - MTM terminal prompt device name 
e PRMTSEQ - MTM terminal prompt sequence 

@e QUESIZE - MTM task queue size 

@e SGN.ACT - Number of accounting classes 


@ SGN.ASST - Number of MTMASST tasks 

e SGN.BTCP - Batch job pause 

e SGN.MVOL - Default user volume 

e SGN.PRIO - Batch job relative priority 
@ SGN.ROLL - Forced roll 


e SGN.SCHR - Scheduling mechanism 
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e SGN.SPI. - Number of SPL/32 send data buffers 

e SGN.VAR - Number of global and local variables 
e SGN.@GLO - Number of new global variables 

@ SGN.@INT - Number of internal variables 

e SGN.$HSP - HASP interface 


e UIOLIM -~ I/O count limit for each accounting user class 


e UPRCLIM Processor time limit for each accounting user class 


@ VERSION 


MTM version identification 


2.4.1 Sector Buffer Size (CDBUFSIZ) Option 


The CDBUFSIZ option specifies the number of sectors in a_ sector 
length buffer. For example, using this option to increase the 
length of the buffers for the DISPLAY FILES and variable-related 
commands causes a corresponding increase in the speed of MTM. 
The standard MTMPARMS file specifies a value of 3 for this 
option. To modify the standard value, edit this option as 
follows. 


Format: 
CDBUFSIZ EQU n 
Parameter: 
n is a decimal number from 0 to 6. 
Functional Details: 
The size of each sector buffer is set according to the’ following 
formula: 


(CDBUFS1Z*256) +256 


The use of this option to increase the speed of the DISPLAY FILES 
command pertains only to files on disks that have been marked on 
with a secondary directory. The number of sectors calculated by 
the CDBUFSIZ option are read from the SYSTEM.DIR file each time 
a DISPLAY FILES command is executed. 
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If the disk is marked on with a secondary directory that can be 
contained in memory, MTM scans the memory buffer to search the 
directory. If CDBUFSIZ is set to 0, MTM does not scan the 
secondary directory to get the desired files; instead, the 
primary directory is scanned. 


When variable support is included in an MTM system, the size and 
number of sector buffers allocated determine the number of 
variables that can be contained in memory. Sometimes a user will 
attempt to define more variables than can fit into the user's 
allocated sector buffers. When this occurs, one of the allocated 
sector buffers is paged to disk and a freed sector buffer is made 
available to the user. This allows the user to define more 
variables. 


2.4.2 Special Console Buffer Size (CONBFSZ) Option 


The CONBFSZ option specifies the maximum length of the special 
console buffers generated by the NCONBFS) option. Since no 
special console buffers are reserved by the standard MTMPARMS 
file, the standard value of this option is 0. To specify the 
maximum length of each special console buffer reserved by MIM, 
edit this option as follows. 


Format: 


CONBFSZ EQU n 


Parameter: 


n is 0 or a decimal number from 72 to 32,767 
specifying the length of each special console 
buffer in the system. If the standard value 
of this option is changed, the value of n 
should be greater than the number specified in 
the command buffer size (CSBFSZ) option (see 
Section 2.4.3). 


2.4.3 Command Buffer Size (CSBFSZ) Option 
The CSBFSZ option sets the maximum length of the MIM system 
command buffers, including the buffers used for CSS commands. 


The standard value for this option is 80. To modify the standard 
value, edit this option as follows. 


Format: 


CSBFSZ EQU n 
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Parameters: 
n is a decimal number from 72 to 1,024. 


Functional Details: 


Since the last position of the command buffer is used for the 
Carriage return (CR) character, the user should define a command 
buffer length one greater than needed. If a number less than 72 
is specified for n, a message is output and MTM goes to EOT code 
7 when MTM is started. 


2.4.4 Input/Output (1/0) Class Table (IOTAB) Macro 
The IOTAB macro defines values for the I/O class’ table. TO 


change the default values, enter the IOTAB macro instruction as 
follows. 


Format: 


[label] IOTAB (classno,classid[,iocount]), 


Fea 
(classno,classid[,iocount]), 


Operands: 


classno is a decimal number from 0 to 31 specifying a 
device or file class number. 

classid is a 4-character alphanumeric user-specified 
class identification associated with each 
device or file class. The classid is 


installation-dependent. 


iocount is a decimal number from 0 to 1,000,000 
specifying the maximum number of I/O transfers 
to which each batch job associated with a 
particular device or file class is limited. 
If iocount is omitted, the default is 0 (no 
limit on I/O transfers). 


Functional Details: 
MTMSGN defines default values for the first four classes of the 


I/O class table as follows: 


IOTAB (0,INDX,0),(1,CNTG,0),(2,DEV,0),(3,SPL,0) 
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These default values may be modified by appending the IOTAB macro 
call, with the desired parameters, to the MTMPARMS.xxx file. 
This is demonstrated in Section 2.3. 

2.4.5 Multi-Terminal Monitor (MTM) Link (LINKOPT) Option 

The LINKOPT option sets the maximum number of I/0 blocks’ and 
logical units available to MT. The standard MTMPARMS file 


permits four I/O control blocks and 30 logical units. To modify 
the standard values of LINKOPT, edit this option as follows. 


Format: 


LINKOPT n,m 


Parameters: 


n is the maximum number of I/O control blocks 
available to MTM. 

m is the maximum number of logical units 
available to MTM. 


Functional Details: 


The number of I/O control blocks need only be four, even ina 64 
user MTM environment. 


The minimum number of logical units that should be specified can 
be determined by the following formula: 


logical unit (lu) = 6+(NCSSLVS+1)*NUSERS or 254, 
whichever is smaller. 


MTM dynamically allocates logical units to subtasks as needed. 
The actual number of logical units available to MTM for dynamic 
allocation can be calculated as follows: 


available logical units = (number of logical units specified 
at MTM sysgen (LINKOPT) ) -NUSERS-6. 


To avoid a decrease in response time, the recommended number of 
logical units for NUSERS greater than 5 is: 


6 +NUSERS * 2+ (NCSSLVS*2) 
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To determine if the number of logical units specified by LINKOPT 
is sufficient, check the number of times MTM goes into an lu wait 
state by using the .MTM STATUS,WAIT command. This command 
returns a table similar to the one shown below. 


-_MT™M ST,W 
13:14:32 -_MTM: TOTAL PEAK CURRENT WAITS 
13:14:34 -MTM: 42 34 ll 0 CMD BUFFERS 
13:14:37 .MTM: 0 0 0 0 CON BUFFERS 
13:14:40 .MTM: 7 4 0 0 SEC BUFFERS 
13:14:42 -MTM: 50 24 19 0 LU 


A decision to increase or decrease the number of logical units 

specified by LINKOPT can be based on information returned by the 

-MTM STATUS, ,WAIT command. 

The MTMMAIN object module has the following Link OPTION commands 

imbedded: ; 
OPTION COMMUNICATION, CONTROL, XSVC1,ETASK, INTERCEPT, ABSOLUTE=0 


These options can be overridden by using the NDCMD command to 
suppress imbedded Link options or by explicit specification of. 
desired options using Link commands. 


The Link options IOBLOCKS and LU are contained in the MTMSGN 
source module. These options are selected as described above. 


For more information on Link commands and options, see the 0OS/32 
Link Reference Manual. 

2.4.6 Number of Special Console Buffers (NCONBFS ) Option 

The NCONBFS option specifies the maximum number of special 
console buffers that can be used concurrently during MTM 
execution. No special console buffers are specified in the 
standard MTM sysgen parameter file. To specify the number of 


special console buffers to be reserved, edit this option as 
follows. 


Format: 
NCONBFS EQU n 
Parameter: 


n is a decimal number from 0 to 64. 
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Functional Details: 


The maximum number of special console buffers that can be used at 
one time is equal to the number of users (NUSERS). These special 
console buffers are used only when an I/O request is made to a 
user terminal that requires an I/O buffer larger than the size 
specified in the command buffer size (CSBFSZ) option. An example 
of this is the use of graphic buffers. 


Table 2-1 shows buffer types used in different situations. 


TABLE 2-1 BUFFER TYPES USED FOR 
SPECIFIC I/O REQUESTS 


READ H WRITE 


I/O REQUEST SIZE \ 
1 < CSBFSZ ' TUB 1 TU 
Se aoe ee eae Se aS See Saas ee ee 
! > CSBFSZ and i 
} & CONBFSZ ! CON ! CON 
Bees ee ee we mam a mer et cee ce ie ts cee are ee ufo i ae mn oe a sci auger ater es Sek ~f 
' > CSBFSZ and | TRUNCATE to } ! 
CONBFSZ = O ! CSBFSZ ' DIRECT 
H ss ome Suet Spe cy glee Waa oes AM wai bcs ask “ci Nek ss oleae Se en ges it es et Ee tyler sags nea alae cu agi ila Wee cee ahd Sad ag. ate sess : 
' > CONBFSZ ' TRUNCATE to !} ! 
! ! CONBFSZ ! DIREC 


Where: 


TUB (terminal is the dedicated buffer of size CSBFSZ for 
user buffer) each user. 


CON (console) is the special console buffer of size CONBFSZ. 


TRUNCATE truncates the read request. 
DIRECT performs the write request directly from the 
task. The task is made nonrollable for the 


duration of the I/O call. 
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The decision to buffer large writes through the special console 
buffers or to perform the write directly from the task, should be 
based on: 


e the speed of the terminal, 
@e the size of the write, and 
e the impact on other system users. The user task (u-task) is 


nonrollable for the duration of the write request. 


If an insufficient number of console buffers is allocated, a 
deadlock between two tasks might occur; e.g., both tasks enter 
into a console buffer wait state. If this happens, one of the 
two tasks involved should be cancelled. This deadlock situation 
is likely to occur if the special console buffers are used _ for 
read purposes and there is an insufficient amount of task space, 
causing tasks to be rolled. To monitor the number of console 
buffer waits, enter the .MTM STATUS parameter with the WAIT 
option. 


2.4.7 Number of Command Buffers (NCSBFS) Option 

The MTM program requires a minimum number of command buffers as 
follows: 

e One buffer for each user (terminal or batch job) 

e One buffer for each active CSS level 

e One buffer for each MESSAGE command 


e One buffer for each BROADCAST message 


e One buffer for each new global or internal variable 


MTM terminal response time depends on the number of available 


command buffers. To avoid poor performance, an adequate number 
of buffers must be allowed for MTM use. During MTM sysgen, three 
command buffers are reserved for each user; additional buffers 


can be reserved according to the number of CSS levels that may be 
active under MTM. The NCSBFS option tells MTM how many 
additional command buffers are to be reserved. The standard 
value for the NCSBFS option is 10. The length of these command 
buffers is specified by the CSBFSZ option. 
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To modify the standard value, edit this option as follows. 
Format: 

NCSBFS EQU n 
Parameter: 


n is a decimal number specifying the number of 
additional command buffers that can be used by 
the MTM system. Use the following formula to 
calculate n for your installation: 


n = (number of uSers) x (number of CSS 
levels + 1)/3 


The minimum number for n is 0O. 


Functional Details: 


Response time may be adversely affected if the value specified 
for n is too small. Conversely, memory space is wasted if n is 
set above the maximum buffers needed. 


The program development feature of MTM uses new global and new 
internal variables extensively. A user who plans to use the 
program development feature or expects to use a large number of 
new global and new internal variables, may require a large number 
of command buffers. In such cases, the value of NCSBFS should be 
increased beyond that of the calculated formula above. The 
recommended minimum number of extra command buffers that should 
be specified per user of the program development feature is 15. 


The following methods can be used to judge whether the specified 
value for n is too small or too large for a particular system: 


e Terminate MTM with the .MTM QUIESCE command. At end of task, 
MTM outputs the number of times it had to wait to get a 
command buffer. 


e Enter .MTM STATUS,WAIT at the system console. This command 
displays the total number of buffers available, peak usage, 
current usage and the number of times MTM had to wait for 
system resources on the user's behalf. 


@e Enter .MTM STATUS,USED at the system console. This command 


displays, in histogram form, the number of times each command 
buffer was used during MTM execution. 
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2.4.8 Number of Command Substitution System (CSS) Levels 
(NCSSLVS) Option 


The NCSSLVS option sets the maximum nesting depth of CSS 
routines. If one CSS routine tries to call another and exceeds 
the designated depth, the system responds with an error message 


and CSS processing ceases. To modify the standard value, edit 
this option as follows. 


Format: 
NCSSLVS EQU n 
Parameter: 


n is a decimal number specifying the maximum 
number of CSS levels. The minimum value for 
n is one; the maximum value is 1,024. 
2.4.9 Number of Message Buffers (NMSGS) Option 
The NMSGS option defines the maximum number of message buffers 
that MTM can reserve for operator commands and accounting 
messages from the file manager. The standard value for this 


option is NUSERS. To modify the standard value, edit this option 
as follows. 


Format: 
NMSGS EQU n 
Parameter: 


n is a decimal number from 1 to 1,024. A 
recommended value for n is NUSERS. 


Functional Details: 
MTM reserves 76 bytes per buffer. If these buffers overflow, the 


following message is displayed by the operating system: 


SVC6-ERR TYPE=NMSG POS= 
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2.-4.9a Number of MTMASST Tasks (SGN.ASST) Option 


The number of MTMASST tasks (SGN.ASST) option specifies the 
number of MTMASST tasks that MTM can use. The standard MTMPARMS 
file specifies one MTMASST. To change this option, edit it as 
follows: 


Formats: 


SGN.ACCT EQU n 


Parameters: 


n is a decimal number from 0 to 10, where n is the 
number of MTMASST tasks to be used. 


Functional Details: 


MTMASST performs file handling services for MTM. This allows MTM 
to service other users while a file handling function is being 
performed on behalf of a particular user. File handling services 
include logical unit (lu) assignments (ASSIGN), file allocations 
(ALLOCATE, XAL, SPOOL, TEMP, etc.), file deletions, CSS calls, 
file positioning, etc. 


When 0 is specified for n, no MTMASST tasks will be loaded or 
used. 


As a general rule for selecting the number of MTMASST tasks, use 
one MTMASST task for each ten very active signed-on users or one 
MTMASST task for each 20 active’ Signed-on users. The recommended 
way to determine the number required for a given system is to use 
the Display Accounting command at. the system console. If there 
are no I/O counts on the highest number MTMASST task, or if a 
very small number exist, the -n parameter should probably be 
reduced. If there is a high I/O count on the highest numbered 
MTMASST (i.e., the highest numbered MTMASST task is being used 
as, or nearly as extensively as the other MTMASST tasks) then the 
n parameter should be increased. 
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2.4.10 Number of Sector Length Buffers (NSECTS) Option 


The NSECTS option specifies the maximum number of sector length 
buffers that can be used by MTM for commands that require this 
buffer type. These commands are DISPLAY FILES, $GLOBAL, $LOCAL, 
$SET and $FREE. The number of sector length buffers specified by 
the standard MTMPARMS file is NUSERS/2. To modify the standard 
value, edit this option as follows. 


Format: 


NSECTS EQU n 


Parameter: 


n is a decimal number specifying the maximum 
number of 256-byte sector buffers. The 
minimum value for n is 1. A recommended value 
for n is NUSERS/2. 


Functional Details: 


When variable support is included in an MTM system through the 
SGN.VAR option, a sufficient amount of sector buffers should be 
reserved to hold MTM variables. A 256-byte (one sector) buffer 
can contain a maximum of seven variables. The amount of sector 
buffers needed depends upon the number of users, the number of 
variables being used, and the size of the sector buffers. 
Ideally, two 256-byte sector buffers per user should be 
allocated; a maximum of four per user can be allocated to a 
sector buffer pool. Very large sector buffers can also be 
allocated using the CDBUFSIZ option. If an insufficient number 
of sector buffers is allocated, the buffer pool can run empty, 
causing the user to go into a sector buffer wait state. 


When variable information is not required, sector buffers are 
paged to disk. The resulting freed buffers are returned to the 
sector buffer pool. Because of this paging to and from disk, the 
size of each sector buffer is an important factor in processing 
variables. 
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2.4.11 Number of Concurrent Users (NUSERS) Option 
The NUSERS option defines the maximum number of terminal users 
and batch jobs that can be executed concurrently. The value 


specified for this option in the standard MTMPARMS file is 4. To 
modify the standard value, edit this option as follows. 


Format: 

NUSERS EQU n 
Parameter : 

n is a decimal number from 1 to 64. 
2.4.12 Batch Job Processor Time Limit (PRCLIMIT) Option 
The PRCLIMIT option defines the maximum processor (PRC) time (in 
seconds) for a batch job running under MTM. [In a Model 3200MPS 
System environment, PRCLIMIT defines the maximum processor time 
(CPU+APU), for a batch job running under MIM. No processor time 


limit is set by the standard MTMPARMS file. To set the processor 
time limit, edit this option as follows. 


Format: 


PRCLIMIT EQU n 


Parameter: 


n is a decimal number from 0 to 86,400 (24 
hours) specifying the maximum processor time 
(in seconds) to which each batch job is 
limited. If O is specified, no limit applies. 
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2.4.13 Multi-Terminal Monitor (MTM) Terminal Prompt Device 
Name (PRMTDEV) Macro 


The PRMTDEV macro defines the devices to be used with the prompt 
sequences specified in the PRMTSEQ macro. Any terminal device 


not defined by the PRMTDEV macro will use the standard prompt 
sequences. The PRMTDEV macro is used as follows. 


Format: 


Oiabei] PRMTDEV (pname, ,dev; [,...,devn] ) 


[ r-.+,(pname, ,dev, [,... ,devn])n | 
[iaber] PRMTDEV (SIGMA,dev, [,...,devn]) 
Operands: 
pname is the l- to 8-character prompt sequence name 
specified in the PRMTSEQ option (see Section 
2.4.14). 
dev is the device name of the terminal. 
SIGMA is the predefined prompt sequence for _ the 
Perkin-Elmer SIGMA 10 terminal. 
Example: 


PRMTDEV (FOX,CT30,CT32,CT34),(SIGMA,SM5O0) 


2.4.14 Multi-Terminal Monitor (MTM) Terminal Prompt Sequence 
(PRMTSEQ) Macro 


The PRMTSEQ macro defines prompt sequences for terminals 
requiring special prompt sequences. This macro is used in 
conjunction with the MTM terminal prompt device name _  (PRMTDEV) 
macro and is only required if the user wishes to use a terminal 
prompt sequence other than the standard sequence. 
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Format: 


[label] PRMTSEQ 


[label] PRMTSEQ 


[abel] PRMTSEQ 


Operands: 
SIGMA 


pname 


com req 

task exec 
task read 
build-read 


STANDARD 


(SIGMA) 
(pname, , (com-req,x), (task-exec,x), 
(task-read,x), (build-read,x)), 


(pname,, , (com-req,x), (task-exec,x), 
(task-read,x),(build-read,x) )p]} 


(STANDARD, (com-req,x), (task-exec,x), 
(task-read,x),(build-read,x), 


requests the predefined prompt sequence for 
the Perkin-Elmer SIGMA 10 terminal. 


is a l- to 8-character alphanumeric prompt 
sequence name. This parameter corresponds to 
that specified for the PRMTDEV macro. 


is zero to eight ASCII characters defining the 
prompt sequence for a command request. 


is zero to eight ASCII characters defining the 
prompt sequence for task or CSS execution. 


is zero to eight ASCII characters defining the 
prompt sequence for a task read. 


is zero to eight ASCII characters defining the 
prompt sequence for a build read. 


redefines the standard prompt sequence, which 
is as follows: 

e Command read (*,FFFFFF) 

e Task/CSS executing (-,FFFFFF) 

e task read (>,FFFFFF) 

@ Build read (B>,FFFFFF) 


is a hexadecimal pad sequence from zero to 
eight bytes. 


48-023 FOO RO3 


Functional Details: 


The total length of the ASCII character sequence and the 
hexadecimal pad sequence cannot exceed eight bytes. 


When specifying more than one set of prompt sequences, a comma 
must be placed immediately following the last parameter specified 
on a line and an asterisk (*) must appear in column 72 to 
designate continuation of the operands. 


Example: 


PRMTSEQ (BS, (*,O8FF),(-,O8FF),(>,FF),(BUILD>,FF)), x 
(SIGMA) 


2.4.15 Multi-Terminal Monitor (MTM) Task Queue Size (QUESIZE) 
Option 

The QUESIZE option specifies the maximum size of the task queue 

used by MTM. The standard MTMPARMS file specifies NUSERS for 


this option. To modify the standard value, edit this option as 
follows. 


Format: 


QUESIZE EQU n 


Parameter: 
n is a decimal number specifying the maximum 
number of slots for the MTM task queue. The 
maximum value for this option is 200. A 


recommended value for n is NUSERS*3. 


2.4.16 OS/32 Accounting Facility (SGN.ACT) Option 

The SGN.ACT option enables support for the 0OS/32 Accounting 
Facility under MTM. The standard MTMPARMS file does not support 
the Accounting Facility, but to enable support and specify the 


maximum number of device and file classes that can be used, edit 
this option as follows. 


Format: 


SGN.ACT EQU n 
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Parameter: 


n is a decimal number from 2 to 32 specifying 
the maximum number of device and file classes 
to be used by the Accounting Facility. A O 
indicates no accounting support. 


Functional Details: 

The value of n should be greater than, or equal to, the number 
specified in the OS/32 accounting configuration statement. A 
minimum value of 2 is required to support indexed and contiguous 
files. 


2.4.17 Batch Job Pause (SGN.BTCP) Option 


The SGN.BTCP option allows a batch job running under MTM to pause 


without being cancelled. The standard value of this option 
causes a batch job - running under MTM to be cancelled whenever 
execution of that job is suspended. To enable the batch job 


pause option, edit this option as follows. 


Format: 


SGN.BTCP EQU 1 


Functional Details: 

The batch job pause option is enabled by equating SGN.BTCP to 1. 
If this option is enabled, a message is output to the system 
console when a batch job pauses. The system operator can then 
take appropriate action. 

2.4.18 Default User Volume (SGN.MVOL) Option 

The SGN.MVOL option defines the default volume for an MTM user. 
The standard MTMPARMS file defines the system volume as the 


default user volume. To specify a default volume, edit this 
option as follows. 


Format: 


SGN.MVOL EQU C'name' 
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Parameter: 


name 


is the name of the disk volume to be used as 
the default user volume for all users at 


Signon time. This name must be four 
characters; the first character must be 
alphabet.ic, the remaining alphanumeric. If 


less than four characters are used, the 
remaining characters must be blanks, e.g., 
C'MIM '. Four blank characters indicate that 
the default user volume is the system volume. 


2.4.19 Batch Job Relative Priority (SGN.PRIO) Option 


The SGN.PRIO option defines the relative default priority of a 
batch job running under MTM. To modify the standard value, edit 
this option as follows. 


Format: 


SGN.PRIO EQU n 


Parameter: 


is a decimal number from 0 to 20 that is added 
to the MTM default priority (MTMdp) of an 
interactive job to determine the absolute 
priority at which an MTM user's batch job will 
run. For example, the standard value of 6 
indicates that a batch job will run at six 
priorities lower than an _ interactive job 
unless otherwise specified. If 0 is 
specified, 0 is added to the MTMdp of an 
interactive job, indicating that a batch job 
will run at the same priority as an 
interactive job unless otherwise specified. 


Functional Details: 


Default priorities for interactive and batch jobs are calculated 


as follows: 


TYPE OF JOB 
MTM 
Interactive 


Batch 
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PRIORITY 


MTM link priority 
MTMdp = MTM link priority + 12 


MTMdp + SGN.PRIO = MTM link priority + 12 +n 


Once these default priorities are established, any priorities set 
by an MTM user in the SUBMIT command are checked against the 
default priorities. A batch job is always run at the lowest 
possible valid priority and is never run at the same priority as 
MTM. Default priorities for interactive jobs are not affected by 
this option. 


Example: 

If: 
MTM link priority = 128 
SGN.PRIO = 10 


the following become the MTM default priorities of interactive 
and batch jobs: 


140 
150 


Interactive job 
Batch job 


As shown in the following examples, priorities specified by an 
MTM user in the SUBMIT command are checked against the default 
priorities established at MIM sysgen. 


Example: 
Assume the following SUBMIT commands are entered by an MTM user 


(SGN.PRIO=10): 


SUBMIT TEST.JOB, PR=138 
SUBMIT TEST1.J0OB, PR=150 


The priority for TEST.JOB is invalid, because the user’ specified 
the submitted job to be run at a higher priority than the MTMdp 
of 140. The job will be run at 150. 


The priority for TEST1.JOB is valid, because it is lower than the 
MTMdp of 139. 


The batch job TEST1.JOB will be run at the specified priority of 
150. 

Example: 

Assume the following SUBMIT commands are entered by an MTM user. 


The jobs will be run at either the MTMdp for batch jobs or the 
link priorities, whichever are lower (SGN.PRIO=6). 
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LINK 
JOB PRIORITY 


SUBMIT TEST.JOB 128 
SUBMIT TEST1.J0B 200 
SUBMIT TEST2.J0B,PRIO=160 180 


TEST.JOB will be run at the batch priority of 146, which is lower 
than the link priority of 128. 


TEST1L.JOB will be run at the link priority of 200, which is lower 
than the batch priority of 146. 


TEST2.JOB will be run at the link priority of 180, which is lower 
than both the submit priority of 160 and the batch priority of 
146. 


2.4.20 Forced Roll (SGN.ROLL) Option 


In most operating system environments, it is desirable to make 
every task running under MTM rollable. With the SGN.ROLL option 
enabled, every task except executive tasks (e-tasks) loaded by 
MTM is made rollable at load time. The standard MTMPARMS file 
enables forced roll. To disable forced roll, edit this option as 
follows. 


Format: 
SGN.ROLL EQU O 


Functional Details: 


This option applies only to the private image segment of the 
task. Shared segments are not rolled. See the OS/32 Application 
Level Programmer Reference Manual for a description of the task 
image segments established by Link. 


2.4.21 Multi-Terminal Monitor (MTM) Scheduling (SGN.SCHR) Option 


The user can select one of three scheduling techniques available 
through the SGN.SCHR option: 0O8S/32 priority scheduling, dynamic 
priority scheduling and the MTM priority scheduling mechanism 
(PSM). The PSM is required for use of the load leveling 
executive (LLE) on a Model 3200MPS System (see Chapter 6). 
Dynamic priority scheduling is specified by the standard MTMPARMS 
file. To modify the standard value, edit this option as follows. 
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Format: 


SGN.SCHR EQU n 


Parameter: 


n may be 0, 


1 or 2 where: 


@e O indicates OS/32 priority scheduling. 


e 1 indicates dynamic priority scheduling. 


e 2 indicates the MTM PSM, 


Functional Details: 


When 0 is selected for n, no special task scheduling is done 


MTM subtasks. 
i.e., tasks 
time-slice 


The 
run 
from the 


standard 
are 
value 


information 


When 1 is 
scheduling 
scheduling, 
priorities, 
from 20ms to 2 minutes. 
that 
to the next lower priority 
I/O-intensive tasks (i.e., tasks 
consume their time-slice) are 
priority and their time-slice is 
MTM subtasks by 0OS/32 ensures 
terminal I/O are adjusted to the 


selected for n, 
is activated for 
a task's priority is 


and 


When 2 is selected for n, the 


subtasks. PSM increases 


namely I/O and 


this behavioral information, 


subtasks whose initial load priorities had been in the 


*4+12 to *+128, where * equals 


SET SLICE command. 
priority are scheduled on a first-in/first-out (FIFO) basis. 
the OS/32 Application Level Programmer Reference Manual for 
on 0OS/32 priority scheduling. 


dynamic 
MTM 


MTM PSM 
system throughput by 
priorities of MTM subtasks according to their run-time 
computation intensity. 
check on the run-time behavior of all MTM subtasks and based 


for 


task scheduling of OS/32 is used; 
according to 


their priority and the 
Tasks of equal 
See 


more 


priority and time-slice 
subtasks. Through dynamic 
adjusted through a range of 13 


while a task's time-slice is adjusted through a range 
Computation-intensive tasks (i.e., tasks 
consume their time-slice without an interrupt) are adjusted 


their time-slice is doubled. 
that are interrupted before they 
adjusted to the next higher 
halved. Dynamic scheduling of 
that tasks requiring interactive 
highest allowable priority. 
is activated for MTM 
adjusting the 
behavior: 
PSM performs a periodic 


on 
PSM adjusts the priorities of 

range of 
the task priority for .MTM. The 


interval of the above check and thresholds of I/O and computation 


intensity are 
described in Chapter 5. 


controlled by the 


Operator command .MTM PSM 
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All current subtask priorities outside this range and those 
priorities set by the PRIOR command or the SUBMIT command at load 
time are fixed. Fixed priorities cannot be modified by PSM and 
PSM cannot alter the maximum batch priority set by the SGN.PRIO 
option. Table 2-2 summarizes task priority modification when PSM 
is enabled. 


PSM lowers the task priorities of subtasks requiring a relatively 
large amount of CPU time, while raising the priorities of 
subtasks that perform a large number of I/O operations. PSM will 
not raise a task's priority above the priority set at link time 
(except when the task is rolled). 


All priorities assigned by PSM (except for rolled-out tasks) must 
be within the *+12 to *+128 range. To increase the chances of 
entry of a rolled-out subtask into the system, PSM gradually 
raises the priority of the subtask to *t+tl. Once the subtask is 
rolled-in, PSM adjusts its priority immediately within the *+1l2 
to *+128 range. 


Accounting support is required with PSM; both MTM accounting and 
OS/32 accounting must be sysgened for accounting support. 


TABLE 2-2 MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
PSM ENABLED 


oem rie mene wre me eet em eae ae ne me rms ms Darth ee marten me me ete ne em ee em ene ne mmr ee mre es me ee ee me ne me me ee ee ee eee ee ee ee ee. tee 


H ALLOWABLE PRIORITY 
1 
1 


priorities. 


ee ee ee eee 


MODIFICATION 

[emer creer Re SERS REE SRR SR EEE SS See eee SSeS eS | 
- | .MTM | Fixed priority - cannot 
| »«MTMASST | be modified by PSM. } 
; »oPL 
| -SPLR 1 
H SY nt ay coc saat. Sa” ni Ct ‘Gta Si async Wa in“, tei es Si i ie” ac SS (ome eee Sar ci escuela ns ace a, spe Sam ew Se es oem See i 
; * to +1 } None | Fixed priority range - H 
H i ; can be modified by a 
H } } PRIOR or SUBMIT command 1 
: H ; issued by a user with the | 
Pe tbo. FLL ; privilege to alter batch | 
! ! ! 3 
' 

‘ 


* to +12 All MTM inter- Subtasks whose priorities 
active tasks lie within this range can 
be modified by PSM accor- 

* to +13 All batch MTM ding to their run-time 


all tasks (except rolled- 
out tasks) adjusted by 
PSM must remain within 


t 
H 
i i 
} Jobs | behavior priorities for H 
| | . 
| | : 
! | | 
! ; this range. i 
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TABLE 2-2 MODIFICATION OF MTM SUBTASK PRIORITIES WITH 
PSM ENABLED (Continued) 


ALLOWABLE PRIORITY 


PRIORITY DEFAULT TASKS MODIFICATION 
* to +13 PSM raises or lowers task 
(continued) priorities for batch jobs 


as it does for inter- 
active tasks, except that 
PSM cannot raise a batch 
job priority higher than 
the maximum set at MTM 
sysgen (see SGN.PRIO). 


NOTE 


Priorities in this range 
that have been set by 
the PRIOR or SUBMIT 
commands are boundaries 
for PSM. PSM only lowers 
these priorities as need- 
: ed and never raises a 
* to +128 or priority higher than the 
248 (whichever priority set through the 
is smaller) PRIOR or SUBMIT command. 
* to +129 or } Fixed priority range - 
249 (whichever } can be modified by the 
is smaller) | PRIOR command or at link 
i Cime, but only up to 254. 
{ 
! 
H 


we ee ee a ee ee ee ee eee em ee ee ee eee ee ee 
ene ne ee 


Ne Fen ee ek ee ee A RE vk RU A Lee amma tomy me may Wem wee eam ae bn ee mmm ine mime tem ane corm cum cee ee ee ne emai erate ae oe 


NOTE 


To obtain good system performance, use 
the PRIOR 1 command in the standard 
system CSS (on Account 0, system volume) 
for interactive tasks; otherwise the 
tasks are lowered too far in priority. 


Even a user without PRIOR command 
privileges is able to raise a task's 
priority if the PRIOR command is used in 
a CSS file on the system volume and 
system account. 
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See the Multi-Terminal Monitor (MTM) Reference Manual for more 
information on the PRIOR command. 

2.4.22 SPL/32 Interface (SGN.SPL) Option 

The SGN.SPL option gives MTM users access to the SPL/32 software. 
SPI/32 must be configured into the system during 0OS/32 sysgen; 
otherwise, this option has no effect on the system. The standard 
MI'MPARMS file does not enable the SPI./32 interface. Tio enable 


SPL/32 support and specify the desired number of send data 
buffers, edit this option as follows. 


Format: 
SGN.SPL EQU n 
Parameter 
n is the number of send data buffers. 


Functional Details: 


When O is selected for n, SPL/32 support is disabled. If SPL/32 
support is desired, a recommended value for nis NUSERS. 


To judge whether the value specified for n is too small or _ too 
large for a particular system, enter .MTM STATUS,WAIT at the 
system console. This command displays the total number of 
buffers available, peak usage and current usage. 

2.4.23 Global and Local Variables (SGN.VAR) Option — 

The SGN.VAR option specifies the maximum number of global and 
local variables that an MTM user can define. The maximum number 


specified by the standard MTMPARMS file is 28. To modify the 
standard value, edit this option as follows. 


Format: 


SGN.VAR EQU n 
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Parameter: 


n is a decimal number’ from 28 to 1,024 
specifying the combined maximum number of 
global and local variables a user can define. 
If n equals 0, variable support is not 
included in MTM. 


2.4.24 Number of New Global Variables (SGN.@GLO) Option 

The SGN.@GLO option specifies the maximum number of new global 
variables that can be defined by an MTM user via the $DEFINE 
command. The maximum number of new global variables specified by 


the standard MTMPARMS file is 15. To modify the standard value, 
edit this option as follows. 


Format: 


SGN.@GLO EQU n 


Parameter: 
n is a decimal number from 0 to 99 specifying 
the maximum number of new global variables 
allowed. 


Functional Details: 

Each new global variable defined by a user occupies one command 
buffer. Therefore, the number specified for this option should 
be considered when specifying the NCSBFS option. 

2.4.25 Number of New Internal Variables (SGN.@INT) Option 

The SGN.@INT option specifies the maximum number of new internal 
variables that can be defined in an MTM user's CSS command file 
via the $DEFINE command. The maximum number of new internal 


variables specified by the standard MTMPARMS file is eight. To 
modify the standard value, edit this option as follows. 


Format: 


SGN.@INT EQU n 
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Parameter: 


n is a decimal number from 0 to 99 specifying 
the maximum number of new internal variables 
allowed in a CSS command file. 


Functional Details: 


Each new internal variable defined by a user occupies one command 
buffer. Therefore, the number specified for this option should 
be considered when specifying the NCSBFS option. 


2.4.26 HASP Interface (SGN.$HSP) Option 


The SGN.$HSP option allows terminal users to switch from an MT 
time-sharing environment to a HASP environment. The standard 
MTMPARMS file does not enable the HASP interface. To enable the 
HASP interface, edit the SGN.$HSP option as follows. 


Format: 
SGN.$HSP EQU n 
Parameter: 


n is a decimal number from 1 to 99 specifying 
the maximum number of HASP/32 tasks that can 
be concurrently interfaced with the $HASPxx 
command by MTM users. If n equals O, the HASP 
interface feature is disabled. 


2.4.27 Input/Output (1/0) Count Limit Per Accounting User Class 
(UIOLIM) Macro 


The UIOLIM macro defines the maximum number of I/0 transfers, 
within each I/O class, allowed for each task run from a terminal 
or batch stream, for a given user class (0 through 15). To 
define I/O count limits for each user class, first enable the 
OS/32 Accounting Facility using the SGN.ACT option and establish 
I/O classes for MTM using the IOTAB macro. Enter the UIOLIM 
macro as follows: 


Format: 


[label] UIOLIM (ugioot,..-,Ugiont) ,(Uoiogb, ...,Ugionb) 


feeeree 
(Unidgt,...,UniOnt) , (U_ioob, ..-,Unionb) 
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Operands: 


Uniont is a decimal number ranging from 0 to 
1,000,000 indicating the maximum number of I[/0 
transfers to the device assigned to I/0 
class n for all interactive tasks run from a 
terminal for user class n. If uUpiont for a 
given user class is omitted or equals 0, the 
I/O count limits specified for each [/0 class 
by the IOTAB macro are in effect for that 


class. 

Up,_io,b is a decimal number ranging from 0 to 
1,000,000 indicating the maximum number of I[/0 
transfers to the device assigned to I/O 


class n for all batch jobs for user class n. 
If u,io,b for a given user class is omitted or 
equals 0, the I/O count limits specified for 
each I/O class by the IOTAB macro are _ in 
effect for that class. 


Functional Details: 


If a task attempts to exceed an I/O count limit set for the user 
class to which its account belongs, task execution is terminated 
with an end of task code 1210. All outstanding jobs 
corresponding to the exceeded I/O count limit are aborted. 


Because the IOTAB macro defines the I/O classes for MTM, the 
IOTAB macro must precede UIOLIM in the MTM parameter file. 


Interactive I/O counts for all I/O classes must be enclosed in 
parentheses; a comma is then used to separate the interactive I/O 
counts from the batch I/O counts (also enclosed in parentheses) 
for the same user class. Similarly, a comma following the batch 
I/O counts for all 1/0 classes is used to separate the parameters 
for one user class from those of the next user class. 


The following example is designed to illustrate the format of the 
UIOLIM macro and its relationship to the IOTAB macro. 
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Example: 


IOTAB (0, INDX),(1,CNTG),(2,DEV),(3,SPL),(4,TAPE) 


UIOLIM (00,01,02,03,04),(100,101,102,103,104), U CLS O % 
(10,11,12,13,14),, U CLS 1 * 
(20,21,22,23,24),(120,121,122,123,124), U CLS 2 * 
(30,31,32,33,34),(130,131,132,133,134) U CLS 3 * 

I C D S T I 3 D S T 
N N E P A N N E P A 
DT V L P D T V L P 
X G E Xx G E 
TERMINAL BATCH 


Table 2-3 illustrates the [/O count limits set for batch and 
terminal jobs by the above example of UIOLIM. 


TABLE 2-3 EXAMPLE 1/0 COUNT LIMITS SET BY UIOLIM 


; 1/O CLASS 
/ : Si ae eel ces a ee as ch As a cm a fh wt en “Se, Rs Si a a a Shenae tt a a ca a ce ay Stes a a cao fees cet ee eR Sn eal Se a { 
' ' 0 (INDX) H 1 (CNTG) H 2 (DEV) H 3 (SPI) H 4 (TAPE) { 
| ACCOUNTING | -------------------------- 9-2-2 ne nnn nnn eo en ne nen ne en oo ene eee 
{| USER CLASS {| TERM. {| BATCH | TERM. } BATCH {| TERM. ; BATCH ; TERM. |; BATCH | TERM. !} BATCH ; 
| HPN SST ES SEE TE TE Eee ee ESE |} 
H 0 i 7 ; 100 |} 1 ; lol } 2 ; 102 | 3 ; 103 4} 4 + 104 | 
[ote BESS SSS Sars SSeS SS SS eee Se a Se Se er ee ae ee H 
H 1 i; 10 H xx 7 oll i ee y (12 H xx ft 13 i xx of «14 ' ee} 
Poe SA Ste tS eS SSS Set a i Se Te ee en eS ES Ter ST eae a i 
i 2 { 20 ' 120 ; 221 i; 121 ; 22 tf 122 {4 23 } 123 {| 24 ; 124 $$ 
PROS RASS Poe Pet RSS Se SRR tees SSS See Sa See SS merce eer er Ree RSS SS SSeS SSS eee ee i 
; 3 i 30 tf 130 43 321 ; 131 | 32 i; 132 { 33 f 133 | 34 ; 134 | 
De cece es fk ces ed kn see, ek ees Sa ts Gee lees Sl, Se es eel ec eee steko “ea ces doe Ses ee sek cw a i see eas Sl wee ee ca me ete Jk Se cr ee ee ee a aed sce eee ee t 
4 { * : xx H x H Kx : * \ xx { x H xx { x { ax 
* No I/O count limit 

*k 7/0 count limit set by IOTAB macro 

NOTES 


The actual I/0 count limits used in the 
previous example are for illustrative 
purposes only and should not be construed 
as recommended parameters to the UIOLIM 
macro. 
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2.4.28 Processor Time Limit Per Accounting User Class (UPRCLIM) 
Macro 


The UPRCLIM macro defines the maximum processor time allowed for 
each accounting user class for MTM tasks running in a single 
processor system. In a Model 3200MPS System, UPRCLIM defines the 
maximum processor time (CPU+APU) allowed for each accounting user 
class. There is a maximum of 16 accounting user classes (0 
through 15) established in the authorized user file (AUF). Each 
account is assigned to one of the established accounting user 


classes. A terminal session or batch job is limited to the 
processor time designated for the class to which the account 
belongs. To define processor time limits for each user class, 


first enable the OS/32 Accounting Facility using the SGN.ACT 
option. Then enter the UPRCLIM macro as follows. 


Format: 


abel] UPRCLIM limit gt, limitgb,limit,t,limit,b, 


Limity,jt, limityb 
Operands: 


Limit,t is a decimal number ranging from 0 to 86,400 
(one day) indicating the maximum number of 
seconds of processor time allowed any terminal 
session for a user signed on to an account in 
user class n. If lLimit,»t equals OO, no 
processor time limit applies’ to terminal 
sessions under class n. 


Llimityb is a decimal number ranging from 0 to _ 86,400 
(one day) indicating the maximum number of 
seconds cf processor time allowed any batch 
job running under an account in user class n. 
If limit,;b equals 0, the default processor 
time limit is the limit set by the PRCLIMIT 
option at MTM sysgen. 


Functional Details: 


If execution of a task under any account exceeds the processor 
time limit set for the accounting user class to which the account 
belongs, the task is terminated (end of task code 1200). After 
termination, no other tasks can be loaded under that account’ and 
all batch jobs under that account are aborted. 
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Example: 
UPRCLIM 30,30,,,40,3600,80, 10800 


In the above example, the processor time limit for both batch 
jobs and terminal users in accounting user class 0 is 30 seconds. 
Accounting user class 1 has no processor time limit for terminal 
users; batch jobs are restricted by the limit set in PRCLIMIT. 
For user class 2, the processor time limit for terminal users is 
40 seconds, while batch jobs are limited to 3600 seconds (one 
hour). Class 3 users are limited to 80 seconds for terminal 
users and 10,800 seconds (three hours) for batch jobs. For the 
remaining classes, no processor time limits are set for terminal 
sessions; batch jobs running under these classes are limited to 
the value set by the PRCLIMIT option. 


2.4.29 Multi-Terminal Monitor (MTM) Version Identification 
(VERSION) Macro 
The VERSION macro assigns an identification name or number to the 


current revision of the MTM system. To specify an identification 
name for an MTMPARMS file, edit this option as follows. 


Format: 


[label] VERSION ‘id! 


Operand: 

id is a 16-character alphanumeric string 
identifying the current revision of the MTM 
system. Special characters are allowed. If 
blanks are used, the identification name must 
be enclosed in quotes. 

Example: 


VERSION '3230-B' 
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2.5 MEMORY REQUIREMENTS FOR SYSTEM GENERATION (SYSGEN) OPTIONS 
The MTM sysgen options reside in data structures built within the 


MTM task address space. Table 2-4 lists each data structure and 
its size. 


TABLE 2-4 DATA STRUCTURES BUILT BY MTM SYSGEN 


DATA H 

i STRUCTURE | MEAN ING H SIZE (IN BYTES) 

i ee 
i Sysgen ; Contains the sysgen ; 128 

{| parameter {| parameter values to jj; 

; area | be used by the H 

| MTMMAIN module. 

i a cP ta eal ca a a as a a Gl es ts nl a a i aaa te ac cas AS esta css la Geese mace ta eo tain eae em ean ela ta am alg cht ong ase mcm ety aa iat tan eer a eh cet eas eas a es 
i Terminal j; One is built for | 584+(NCSSLVS+1)*8 

i; user ; each concurrent MTM jj; +CSBFSZ+4 

| block i user defined by the ; +SGN .ACT*4+4 

{ (TUB) i NUSERS option. H 

i in aes, Dantas SoA i al tn a ea at ale <a ow, ra ea a a a a Ma ek Sl a a tae, a sk ac estar eh as Ss cn aki, ca eg mas aan Soa a ae eee asa ek 
; Command i Contains the command ; (3*NUSERS+NCSBFS) * (CSBFSZ+4) 
| buffer ; buffers. H 

; area H { 

' is a Sa a ee calc eeee Se a a a ag ene ara Vg Ps a fe fl a a a a a ag a a a aes ec ds Me eh oe aes eka eis Se ee ee mt 
i Special i Contains the pool of {| NCONBFS* (CONBFS2Z+4) 

; console } special console 1 

| buffers | buffers. 1 

| ea, a a a na a Se ss aa cc a a ak a nse Sas Sa tka ha a ny mai Sg Sak Veta a Sh as ac acy ab at, Sg ul ga 
} Message i Contains the message ; 76*NMSGS 

| buffer } buffers. } 

; area H H 

{ ic eS ei SS a masse ns ay aR as as ahs cso SC ca i ei se Stam, “al Cnycaot r seh “ent en Yel oti tS a seks kg ets le “tdi a 
} Sector } Contains the sector i} (256*CDBUFSIZ+256) *NSECTS 

| buffer | buffers. H 

} area 

H i ea a a a sO “es i (litt Eos ica a iy, a Sn a ae “hj nM bch cn GS ns sl ana “ss mG ee: nih” Slee 
|} Circular | Contains the MTM i 4*QUESIZE+8 

+ List ; task queue. 

} area l H H 

H co es minim ic” nhieu “mid aia oben bcs mw a eh ins? Nm “eso ky lh eh “es, Gab“ Wh hm sta mina, in cna ein“ cua“ » s'il “ham” Se’ enn pm ictal amar 
; Circular { Contains the command | 4*NUSERS+8 

} List | buffer wait queue. H 

} area 2 

H eee sm ee ne me Ne ee em NED emt cee maou mint) smh ame OO om cm cen) anes SD mT eae Som SO ee ee SO ne Dn SOD SO co mS SOE aS eh MD Oe ee a DO SS OD 
; Circular ; Contains the console | 4*NUSERS+8 

; List i} buffer wait queue. H 

| area 3 i 

| a nes im, a am ne ssn ee a es a “i a mew mw, Sw“ 9 an es a sn eae pee ew! ne los ce ee 
; Circular ; Contains the sector | 4*NUSERS+8 

} List | buffer wait queue. i 

; area 4 i 
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TABLE 2-4 DATA STRUCTURES BUILT BY MTM SYSGEN (Continued) 


DATA 

| STRUCTURE | MEAN ING SIZE (IN BYTES) 

LSS SoS SSS eS SS SSS SSS MAA SSK SR ae SS SSS SS SSE eee asses SE om 

} Circular j; Contains the lu wait | 4*NUSERS+8 

} list ;} queue. 

} area 5 

H 3am ty pan eae, Sain is ecoregion “Sem inn ews / S-band ns gi caf eset) ee sash hes Saylce 

Circular ; Contains the message | 4*NMSGS+8 

; list | buffer wait queue. 

; area 6 

{ fa cn: ocean eS a il i a cy. ‘eC t ea tS a s en aece aec) ss Seceesd a .ctsen (an  bsmeteens as Mk  ce n ea Tee  e 

; Accounting; Used by MTM to ries | 128 or 8*classes+84 

| write ; accounting informa- ; (whichever is larger) 

| buffer } tion to the account- |} 

i i ing transaction file | 

| (ATF). 

| Ss fa ae eee Stes a a se as ee a a ee ei ee ee ee 
Command Used to accummulate (3*NUSERS+NCSBFS) *4 


t I 

' | 

buffer |} command buffer usage | 
usage | for the .MTM STATUS, | 
| USED command. 

I/O class }; Contains the 1/0 | 
table ; accounting class | 
| name and limits. 
i 


This table is built 

by the IOTAB macro. 

PRC limit |! Contains the PRC H 

table i limits for terminals } 

} and batch jobs for 
t i] 
! | 
i 1 
' t 


each user class. 
Built by the UPRCIL.IM 
macro. 
I/O limit | Contains the I/O } 128*SGN.ACT 
table { limits for terminals } 
ij and batch jobs for i 
} each I/O class by i 
1 i] 
| ! 


user class. Built 
by the UIOLIM macro. 


SPL/32 
send data 


| Contains the mnemon- | 260*SGN.SPI.+532 
' ic table, send data jj} 
| buffer queue and H 
{ gend data buffers H 
; used by MTM and H 
( J 
' i] 


SPL/32. 
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CHAPTER 3 
AUTHORIZED USER UTILITY 


3.1 INTRODUCTION 


Prior to loading and starting the multi-terminal monitor (MTM), 
an installation must establish valid account numbers” and 
passwords for its authorized users. This is accomplished through 
the Authorized User Utility supplied with the MT software 
package. The Authorized User Utility maintains a file containing 
information on each account number. This file is called the 
authorized user file (AUF). 


3.2 AUTHORIZED USER FILE (AUF) 


The AUF contains one record for each account. An account number, 
group number and password are required for each account. In 
addition, user identification, limits for signon and processor 
time and privileges for each account can be optionally specified 
in the AUF. Defaults are set by the Authorized User Utility for 
all optional information not specified by the installation. The 
record format for the AUF is shown in Figure 3-1. 
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Figure 3-1 AUF Record 


Format 
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The Authorized User Utility is used to create, update and report 
on the AUF. : 


Initially, the Authorized User Utility should be run from the 
system console to create an AUF. In order to enable access under 
MTM, the AUF must be renamed to account 255. 


Example: 
RENAME USERS.AUF,USERS.AUF/255 


Once the AUF is renamed to account 255, it can be updated while 
MTM iS running by signing on to account 255 and running the 
Authorized User Utility. 


When the AUF is assigned to account number 255, it is protected 
in two ways: 


@e only users signed on to account number 255 can access the AUF, 
and 


e the Authorized User Utility does not display the password to 
account 255 ina listing. 


When the LIST command of the Authorized User Utility is entered, 
the account number, group account number, user identifier 
(userid), signon time remaining, processor time remaining, 
account privileges and date of last report are displayed. Once 
added to an account record, the password cannot be retrieved from 
the AUF, but can be changed by the CHANGE command. 


Accounting limits and privileges can be specified for each 


account number through one of the following Authorized User 
Utility commands: 


e ADD command (create or update mode), used when adding a new 
account to the AUF. 

@ CHANGE command (update mode), used when making changes to an 
already existing account. 


Two resources can be limited by account number: 


e Signon time 


e Processor time 
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Signon time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can be signed on to the system. Whenever a terminal user 
signs off the system, these limits are checked. If the terminal 
user has used all of the remaining signon time specified for that 
account, or tries to sign on to an account with no signon time 
left, the signon request is rejected and this message is 
displayed: 


NO TIME LEFT 


Processor time can be limited for each account by specifying the 
maximum time the total number of terminal users assigned to that 
account can use time on a processor. In multiprocessing systems, 
processor time includes the total time used on the _ central 
processing unit (CPU) and any auxiliary processing unit (APU) 
assigned to the _ task. Whenever a terminal user's task 
terminates, this limit is checked. If the terminal user has used 
all of the remaining processor time specified for that account, 
this message is displayed: 


YOUR PROCESSOR TIME HAS EXPTRED 


If a terminal user tries to load a task assigned to an account 
with no processor time left, this message is displayed: 


TIME-ERR 


3.3 BUILDING AND STARTING THE AUTHORIZED USER UTILITY 


The Authorized User Utility supplied with the package has been 
linked according to the sequence of Link commands shown below. 
User involvement is only necessary when additional Link options 
are required. In that case, the user must specify the necessary 
option and relink the task. See the OS/32 Link Reference Manual 
for more information. 


L .BG,LINK 
T .BG 
ST 


TITLE ACTUTY 
ESTABLISH TASK 
MAP ,ADDR 

INCL ACTUTY .OBJ 
BUILD ACTUTY 
END 
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The following starts the Authorized User Utility. 


Format: 
CREATE 
. COMMAND 
sranr, | -fd,, LIST=fd> ,< UPDATE =f£d, [, ACCOUNTS=n] 
CMD 
REPORT 
Parameters: 

COMMAND- file descriptor (fd, ) indicates the device or 
file from which command input will come. The 
Authorized User Utility assigns the command 
input device to logical unit 1 (lul). The 
COMMAND parameter can also be entered as C or 
CMD. 

LIST= fda indicates the device or file to which the 
output is sent. The Authorized User Utility 
assigns the list device to 1u3. 

CREATE specifies a mode of operation for the 

UPDATE= Author ized User Utility. The AUF to be 

REPORT created, updated or about which a report 
is needed, is specified by fd3. The 
Authorized User Utility assigns the specified 
AUF to 1u3. 

ACCOUNTS=n mn is a decimal number (0 through 65,535) 
indicating the maximum number of accounts 
allowed in the AUF specified by fd3. In the 


CREATE mode, n indicates the size of the new 
AUF. In the UPDATE mode, n indicates the size 
to which the AUF is to be extended. If the 
ACCOUNTS parameter is not’ specified, the 
maximum number of accounts in the AUF defaults 
to 255 or the maximum set by a previous 
ACCOUNT command. This parameter is ignored 
when the AUF is operating in the REPORT mode. 


Functional Details: 


When the CREATE mode is selected, the Authorized User Utility 
allocates, assigns and initializes the new file specified by fd 3. 
If the file specified by fd3 already exists, an error message is 
generated and the Authorized User Utility goes to end of task. 
If the UPDATE mode is selected, an update to the file specified 
by fd3 is requested. If the REPORT mode is selected, a report of 
the file specified by fd3 is requested. If the specified file 
does not exist for the UPDATE and REPORT modes, an error message 
is generated and the utility goes to end of task. 


48-023 FOO RO3 3=5 


—— ee ee 


The Authorized User Utility assigns all logical units based on 
the parameters specified in the START command. These starting 
parameters can be entered in any order. The user cannot assign 
specific logical units. 
Examples: 

The following example creates an AUF named NEWFILE. The system 
console (CON: ) is the command input device and the line printer 
(PR: ) is the list device. Until the START command is issued, 
the file (NEWFILE) does not exist. The Authorized User Utility 


allocates, assigns and initializes the new file for accounts 1 to 
511. 


START, CMD=CON: ,LIST=PR: , CR=NEWFILE,AC=511 


The next example specifies the console (CON:) as both the 
command input device and the list device. The mode of operation 
is UPDATE an existing file called AUFILE. 


START, UP=AUF ILE, CMD=CON: , LIST=CON: 


3.4 AUTHORIZED USER UTILITY COMMANDS 


The Authorized User Utility commands are: 


e@ ACCOUNTS 
e ADD 
e@ CHANGE 


e DELETE 


@ END 
e LIst 
@ MODE 
@ PAUSE 


e PRIVILEGE 


e® TOTAL 
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The Authoriz 
create, repo 
User Utility 


e The create 


e The report 
account ing 


@e The update mode allows account records to be added, 


modified o 


ed User Utility has three modes of 


operation: 


rt and update. Each mode allows certain Authorized 


commands to be executed (see Table 3-1). 


mode is used to establish a new AUF. 


mode allows an account record to be listed or an 
report for each active account (an account record 
already assigned whether used or not) to be generated. 


r listed. 


TABLE 3-1 AUTHORIZED USER UTILITY MODES 
AND ALLOWABLE COMMANDS 


ae dana" meal 
’ Bb adi sas ae abs ae ety Snes nce ae Gah Reeth Pha a Saat ibe i aes teal ech eens A 
| COMMANDS |} CREATE | REPORT | UPDATE | 
Pe cee ts ea ae ee a ee es es ees ee eee ee a A 
| ACCOUNTS | xf | | 
| ao: we ae go Sf ade ate et as ee : 
Dee ec eet Na Ne le Ae Ge ate oe lee ictal het NS She eee eee NG ns al hee ole Oat Se es Ml 
| CHANGE x | eo] 
Wks catiens weariness oe Sites wen ee Bt as Sees Se ete ee Selah ate ee Bee ln mle 
| DELETE x | Ko 
Deiat a ey SES ee cee al a OS Se Rte Oe re a en Boe ee ee es ae wh 
! END * * ‘ ! 
BND, Se Sek Rae Beene et Sescahetn et N nal lea i Sere geste tame aeih commen et ai sree iterate aoe! saa te ENS ea ee oh eee 
! LISt x | x 4 3 
Ve ask caleinecechestan ols Sak ot fare ane gee Cen eae a Sat cs as ahd teeta alate een ee ee atl Sie AOR ee eae ecaitone ara caat 
! MODE x | 4 x 4 
RS re ety Ge eS heaaliyast neni A ceanactt ea See’ Cte ie Res (eh age eee OES ate red ere een, pebene aie ue eae tae tl 
| PAUSE x 4 e 3 ! 
Voc. Soe nee cane reds pueneth: aah Selicted ese! aioe Ss weet aces gb ens a i, Sette pene cea a dale aw aed! Sane ae oe enews Bate cee TM 
! PRIVILEGE | ae a. ee x | 
! TOTAL =f ES 


ee ee en ee ee eee ee ee een Rennrad 


x Command can be executed in 
specified mode 


*k Display (no operand) form only 
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3.4.1 ACCOUNTS Command 


The ACCOUNTS command raises or lowers the account number limit 
for the AUF. This command also displays the current limit set 
for the file. 


Format: 


ACCOUNTS n 


Parameter: 


n is a decimal number’ from 1 to 65,535 
indicating the account number limit of the 
AUF . If n is omitted, the current account 
number limit is displayed. If the value 


specified for mn is illegal, the ACCOUNTS 
command is ignored. 


Functional Details: 


In the REPORT mode, this command can be used in display form 
only. The Authorized User Utility sets the account limit in 
blocks of 256 records, one account per record. If n does not 
specify the last record ina 256 record block (e.g., 255, 1,023, 
etc.), the value of n is raised to the next multiple of 256. For 
example, if n=100, the account limit is set to 255. 


After the ACCOUNTS command is executed, the following message _ is 
sent to the console: 


ACCOUNT LIMIT = n 


The variable n is the current maximum account number to which the 
AUF has been raised or lowered. If the ACCOUNTS command is 
entered without a value specified for n, this message will 
display the current account number limit in the AUF. 
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Examples : 


ACCOUNT 
ACCOUNT LIMIT 


ACC 1000 
ACCOUNT LIMIT 
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2047 


1023 


3.4.2 ADD Command 


The ADD command establishes an account to the AUF. 


Format: 


x 


S 1gnont ime processortime 
ADD actno,groupno, password, [user id] ' 3 
x 


C privi leges | 


Parameters: 


actno 


groupno 


password 


userid 


signontime 


is a decimal number from 1 to the current 
account limit specifying the account number to 
be established. 


is a decimal number from 1 to the current 
limit (except 255) specifying a group account 
number to which the private account number is 
to be assigned. Group number 255 is valid 
only aS a group number for account 255. 


is a 1l- to 12-character alphanumeric” string 
specifying the password to be established for 
the account. 


is a l- to 20-character alphanumeric” string 
specifying the account user's identification. 


is a decimal number specifying the number of 
seconds of signon time to which the account is 
limited. If an asterisk (*) is specified, no 
limit is applied. For convenience, this 
parameter may be entered in any of the 
following formats: 

e hh:mm:ss 

® mm:ss 

@ seconds 


For example, 1:30:10, 90:10 and 5410 all 
represent the same limit. 
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‘processortime 


privileges 


is a decimal number specifying the processor 
time (CPU+APU) to which the account user is 
limited. If this parameter is omitted, the 
default established at MTM system generation 
(sysgen) is used. If an asterisk (*) is 
specified, no Limit is applied. This 
parameter may be entered in the same formats 
as signontime. 


is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. If this parameter is not 


specified, the default privileges OO00A800 
(RENAME, ENVIRONMENT AT SIGNON and PRIVATE CSS 
EXECUTION) are assigned to the account. See 
Section 3.4.9 for information on account. 
privileges and their corresponding hexadecimal. 


codes. 


Functional Details: 


This command cannot be used in REPORT mode. The account adde 
the AUF must be inactive. If the account number is~ active, 
error message is generated and the existing record is 
changed. The Authorized User Utility mode must be CREATE 
UPDATE. A copy of the record is written to the log device. 


Account 255 must be added when the AUF is first created. 
warning results if account number 255 does not exist when 
Authorized User Utility is terminated. 


The privileges for account 255 are set to FFFFFFFF regardless 
the privileges specified when account 255 is established. 
Example: 

The following ADD command adds a new account to the AUF with 


following information: the account number is 1000, the g 
number is 250, the password is RAY, the userid is DEPT 2, 


d to 
an 
not 
Or 


the 
roup 
the 


signon time limit is 9999:59:59, and no processor time limit is 
set. The privileges in effect are SVC6 COMMUNICATION, CHANGE 
PASSWORD, PRIVATE CSS EXECUTION, TEMPORARY and SPOOL FILES, 


ENVIRONMENT AT SIGNON and RENAME. 


ADD 1000,250,RAY,DEPT 2,9999:59:59,*, 8000F800 


1000 250 DEPT 2 9999:59:59 me 8000F800 03/03/83 
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3.4.3 CHANGE Command 


The CHANGE command changes fields in the AUF record of an active 
account. 


Format: 


SL yg FGA Ro ean Ree be Rw KEP SY ES 


signont. ime 
CHANGE actno, (groupno], [password], [user id] 4 


x 
processortime 
| {, privileges] 
x 


Parameters: 


actno is a decimal number from 1 to the current 
account limit specifying the account number to 
be changed. 


groupno is a decimal number from 1 to the current 
account limit (except 255) specifying the 
group number to which the account is to be 
assigned. Group number 255 is valid only as 
a group number for account 255. 


password is a l- to ]l]2-character alphanumeric’ string 
specifying the password for the account. 


userid is a l- to 20-character alphanumeric string 
specifying the user's identification for the 
account. 


signontime is a decimal number specifying the additional 
signon time to which a terminal user is 
limited. If an asterisk (*) is specified, the 
currently established limit is changed and no 
Limit is applied. For convenience, this 
parameter can be entered in any of the 
following formats: 
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e hh:mm:ss 

e® mm:ss 

e seconds 

For example, 1:30:10, 90:10 and 5410 all 
represent the same limit. 


processortime is a decimal number specifying the additional 
processor time to which the terminal user is 


Limited. If an asterisk (*) is specified, the 
currently established Limit is changed and no 
limit is applied. This parameter can be 


entered in the same formats as signontime. 


privileges is a hexadecimal number specifying the 
privileges to be allowed for users signed on 
under this account. See Section 3.4.9 for 
information on the account privileges and 
their corresponding hexadecimal codes. The 
privileges for account 255 default to FFFF 
FRFF . 


Functional Details: 


This command cannot be used in REPORT mode. As each record is 
changed, a copy of the original and resultant record is sent to 
the list device. 


The values of signontime and processortime are added to the 
current signontime and processortime limits in the AUF to 
increase the time allocations. In a Model 3200MPS System, 
processortime is equal to the additional CPUtAPU time to which 
the terminal user is limited. To decrease the time allocation, 
precede signontime or processortime with a minus sign (~-). An 
asterisk (*) causes the limit to be disabled. 


Example: 
The following CHANGE command changes the processor time limit for 


account number 1000 from unlimited processor time to a limit of 
1:30:10. 


CH 1000,,,,,5410 
1000 250 DEPT 2 9999:59:59 aa 8000F800 03/03/83 
1000 250 DEPT 2 9999:59:59 1:30:10 8000F800 03/03/83 
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3.4.4 DELETE Command 


The DELETE command makes an active account inactive. 
Format: 
RELETE actno 


Parameter: 


; actno is a decimal number from 1 to the current 
account Limit (except 255) specifying the 
account number to be made inactive. 


Functional Details: 


This command cannot be used in REPORT mode. A copy of the 
deleted record is written to the list device. 


Examples: 


The following DELETE command deletes account number 207. 


DEL 207 
207 205 308503154TEMP SHOBER** es A800 02/18/83 


{ The following command attempts to delete an inactive account. 


DEL 207 
*** ACCOUNT NUMBER 207 WAS INACTIVE 
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3.4.5 END Command 

The END command closes all logical units and terminates’ the 
Authorized User Utility. 

Format: 


END 


Functional Details: 


If the Authorized User Utility is ended and account 255 does not 
exist, the Authorized User Utility issues a warning that the user 
has created an AUF that cannot be accessed later. 


Example: 
END 
** WARNING ACCOUNT 255 DOES NOT EXIST 
LAURIE -END OF TASK CODE= 0 PROCESSOR=9 : 43:33:04 TSK-ELAPSED=10:30:34 | 
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3.4.6 LIST Command 

The LIST command displays active account records to the list 
device. . 

Format: 


List [actno, [, actno,}] 


Parameters: 


actno, is a decimal number from 1 to the current 
account limit specifying the account numbers 
to be displayed to the list device. If used 


in conjunction with actno,, it specifies the 
beginning of a range of account numbers to be 
Gisplayed to the list device. 


actno, is a decimal number from 1 to the current 
account limit specifying the end of a range of 
account numbers to be displayed to the list 
device. 


Functional Details: 
When no account number is specified, all active accounts) are 
listed. When only actno, is specified, only actno; is listed. 


When two account numbers are specified, all account numbers’ from 
the first account number to the second account number are listed. 


Examples: 


In the following example, a single account is listed. 


LIST 1000 
PROCESSOR 
ACT GRP NAME TIME LEFT TIME LEFT PRIV DATE 
1000 250 DEPT 2 9999:59:59 ax 8000F800 03/03/83 
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A range of accounts is listed 


LIST 200,1000 


ACT 

201 205 
207 205 
211 205 
230 230 
1000 250 
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GRP - 


NAME 
308503154TEMP SHOBER 
308503154TEMP SHOBER 
308503154TEMP SHOBER 
035713087CAROL CARCH 
DEPT 2 


in the following example. 


TIME LEFT 


xx 
xx 
xx 
xx 


9999:59:59 


PROCESSOR 


TIME LEFT | 


xx 
xx 
xx 
Kk 


1:30:10 


PRIV 
OOOO0A800 
O0000A800 
OOO0A800 
OOO0A800 
8000F800 


DATE 

02/18/83 
02/18/83 
02/18/83 
02/18/83 
03/03/83 


3.4.7 MODE Command 
The MODE command displays the current mode, changes the current 


mode of the Authorized User Utility, or reassigns or creates an 
AUF. 


Format: 


CREATE 
MODE | {UPDATE > | [--fdg | 


REPORT 


Functional Details: 

The MODE command with no parameters displays the current mode. 
When a mode is specified, the mode is reassigned but the AUF is 
not changed. When fd3 is specified, the mode is changed and the 
AUF is reassigned. 

When the create mode is specified, an error message is generated 
if fd3 exists. The Authorized User Utility allocates the new AUF 
and initializes it for the number of account records currently in 
effect. 

Examples: 


To place the Authorized User Utility in the REPORT mode: 
>»MODE REPORT 
To display the current mode: 


»M 
cca: REPORT IS THE CURRENT MODE 
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3.4.8 PAUSE Command 

The PAUSE command pauses the Authorized User Utility and 
transfers control to the operating system. If the Authorized 
User Utility is running under MTM, control is transferred to MT. 


The CONTINUE command returns control to the Authorized User 
Utility. 


Format: 


PAUSE 
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| PRIVILEGE | 
3.4.9 PRIVILEGE Command 


The PRIVILEGE command can be used to change or display the 
privileges for an account or range of accounts. 


Format: 
privilege 
PRIVILEGE |actno, [-actno,] |, 
* 
Parameters: 
actno is a decimal number from 1 to the current 
account limit specifying the account number or 
the start of a range of account numbers of 
which the current privileges are to be changed 
or displayed. If this parameter is omitted, 
the default is all currently active accounts. 
actno is a decimal number, from actno + 1 to the 
current account limit, specifying the final 
account number of the range to be changed or 
displayed. 
privilege is the hexadecimal mask of the privileges’ to 


be assigned to the specified account or range 
of accounts. If an asterisk (*) is specified, 
the default privilege OOO0OA800 is used. If 
this parameter is omitted, the current 
privileges of the specified account or range 
of accounts are displayed. 


Functional Details: 


If an MTM terminal user has been given BARE DISK ACCESS and 
EXTENDED ACCOUNT ACCESS privileges, this user can secure SHARED 
READ ONLY (SRO) access to files belonging to account 255 from 
other MTM accounts. Account 255 should be accessed by as few 
users as possible to ensure security. 


Table 3-2 provides account privilege descriptions and their hex 
mask values. Multiple privileges are granted by performing 
hexadecimal addition of the required privileges and then 
specifying the cumulative hex mask via the privilege parameter. 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES 
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8000 0000 {| Supervisor call 6 (SVC6) Communication - 
| allows the user to load a task with task H 
| communication enabled. If a user without H 
; this privilege loads a task with the SVC6 H 
;} communication option, MTM disables the H 
| option when the task is loaded. 1 
| E-task - allows the user to load executive H 
| tasks (e-tasks). If a user without this H 
| privilege attempts to load an e-task, an { 
| error message is generated and the task is H 
| not loaded. { 


0400 0000 } SVC6, logical processing unit (LPU) and APU | 
| Control - allows a user to load tasks with H 
i SVC6 control enabled. At load time, MTM 1 
; checks the task's requested options against | 
;} the user's privileges. If MTM discovers H 
; that the user does not have the SVC6 control } 
{|} privilege requested by the task, MTM dis- { 
| ables the option at load time. If this 
{ option is set, the user may load a task with | 
; an LPU number other than O or may use the { 
| OPTIONS LPU=n and OPTIONS NIL.PU command. The | 
} user may load tasks with APC and APM options |} 
; set (SVC13) at link time. If a user without |} 
i this privilege loads a task, MTM resets the ; 
;} task LPO number to O (issuing a warning to { 
| the console) and disables the APC and APM H 
{| options upon loading the task. H 
‘ 

| 

| 

4 

| 
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0080 OO00 Extended Account Access ~- allows the user to | 8 
enter an account number in addition to a 
class in an fd. This extended access is 
allowed for the commands RENAME, ASSIGN and 
LOAD, and for command substitution system 
(CSS) calls. File access is limited to 
shared read-only (SRO) for accounts other 
than the user's private account. Without 
this privilege, a user can only enter file 
classes in an fd; i.e., P, G, S&S. 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 


HEX MASK 


0040 0000 


' 


Ce ed 


0008 0000 


te ee ee ee ener tee me ee sm em em ee ce eek a em ke ee ee a ee ee ie mee ee ee a ne ne 


0002 0000 


ee ne en ee ee met 


{ 
1 
' 
' 
H 
i 
| 
jb 
U 
' 0000 8000 
t 
' 
J 
} 
{ 
i 
\ 
\ 
H 
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0000 2000 
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PRIVILEGE AND DESCRIPTION 


i! 
u 


Set Group - allows the user to change the 1 
group account number of an account via the ! 
SET GROUP command. If a user without this { 
privilege attempts to use the SET GROUP 1 
command, an error message is generated. The | 
user's new group account number is retained } 
until signoff or until changed by another 
SET GROUP command. The user's group number § | 
is not changed in the AUF. No user may set | 
a group account to 255. 
Task Account Privilege - allows the user to j; 12 
load tasks with the account privilege task ! 
option enabled. If a user without this 1 
privilege attempts to load a task requesting ; 
this option, MTM disables the option. 


ee meee eee ee ee ee ee ee Oe 


Bare Disk Access - allows the user to access |} 
bare disks for tasks that have this option 
enabled. Users requesting the bare disk 
option without this privilege will have the ; 
option disabled by MTM. H 


—— mee ee ee ee 


Universal Tasks ~ allows the user to run { 
tasks as universal tasks. If a user without ; 
this privilege attempts to run a task with H 
the universal option enabled, MTM disables 
the option and the task is run as a user- { 
task (u- pane 1 


Environment at Signon - permits che use of { 
the ENV= parameter of the SIGNON command. If | 
a user without this privilege tries to use { 
the ENV= parameter, MTM ignores the environ- | 
ment request and forces the USERINIT.CSS to ;{ 
be executed. : 


Temporary and Spool Files - permit a user to | 
display the filenames of temporary and spool | 
files. If a user without this privilege 
attempts to display temporary or spool file j; 
fds, MTM returns *TEMPFILE* and *SPOOLFILE*. | 


Private CSS Fxecution - permits a user to { 
execute private CSS files. A user without H 
this privilege is limited to system CSS i 
calls. { 
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TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 
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1 Change Password - permits a user to select a } 
; new password via the PASSWORD command. The | 
i new password is entered in the AUF and 
} remains in effect until changed by another 1 
| PASSWORD command or the Authorized User 
} Utility. An error message is generated for | 
; users without this privilege attempting to jj; 
i use the PASSWORD eommants 
0000 0800 } Rename - Beeiaes a user to rename eriveke 1 20 

| files to group or system files; i.e., G, S. t 

| If a user also has the EXTENDED ACCOUNT 

{| ACCESS privilege, private files may be 

} renamed to any account. Users without this ; 

} privilege may rename files only within their | 

BEdvake accounts. ' 
| Priorities 1] to 11 ~ permit a user to 
; employ the PRIOR command in a private CSS H 
; to set a task's priority within the range of | 
| -MIM+1 to .MTM+l1l. The maximum priority 
} available to users without this privilege is | 
} «.MTM+12. Priorities .MTM+] to .MTM+11 are 
| always available to system CSS calls regard- |} 
| less of a user's privileges. H 
0000 0200 ; Batch Priority - allows a user to raise the |} 
i priority of a batch job above the default H 
} priority. The default priority for batch 
; tasks is .MTM+12+SGN.PRIO. Batch priorities | 
} can be raised through the use of the SUBMIT | 
{| and PRIOR commands. The priority of a batch | 
; task can never be raised above the priority | 
; of interactive tasks (.MTM+12), but users | 
; may lower batch priorities regardless of { 
} their privileges. H 
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HEX MASK 


0000 0100 


0000 0040 


0000 OOOF — 


TABLE 3-2 MTM ACCOUNT PRIVILEGES (Continued) 
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PRIVILEGE AND DESCRIPTION 


Privileged User (Unlimited File Access) - 
allows a user unlimited access to all 
accounts except 255. Users with this 


to change their account numbers. This 
allows users to access the files of any 
account as if they were the user's private 
files; Knowledge of the account's password 


time when moving among accounts; the 
privileges of the account being accessed 
by a privileged user are ignored. 


system through the INQUIRE command. 
Through the DISPLAY FILES command entered 


me eee ee me ee ee me ee ee ee we ee om 


display files in all accounts. 


ee me me mm ae mem ee a ee me ee ee ee re ee te ee 


Foreground Interface - allows the use of the 


1 
' 
} $FOREGROUND interface. If a user without 
; this privilege attempts to connect toa 

| foreground task, an error message is 
i generated. 


| HASP Interface - allows the user to inter- 
| face with HASP tasks in the system. 

| SGN.$HSP must be enabled at MTM sysgen to 
} permit this privilege. A user without this 
{| privilege who attempts to connect with a 

| HASP task receives an error message. 


There are 15 (0 to F) possible accounting 


user classes. Kach account must be assigned 
to an accounting user class. Each accounting 
class corresponds to a set of processor and 


the UPRCLIM and UIOLIM macros at MTM sysgen. 
If limits for each class are not established 


through UPRCLIM and UIOLIM, the limits set 
by PRCLIMIT and IOTAB apply, and all 
accounts effectively belong to the same 


} input/output (1/0) limits as specified by 
! 
{ 
( 
; accounting user class. 


privilege may enter the SET PRIVATE command 


is unnecessary. This privilege also allows 
users to change their group account numbers. 
The user retains all privileges from signon 


This privilege also provides the user with 
the ability to display all batch jobs in the 


with an * in the account field, a user can 


BIT 
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ee ee ee 


i ems cere amare am mR ae mm mem cn te em moe ce ee me em a ee ee ee eee em ee et es ey ee em cies a ce 


a eR Oe SOR Os RIO Dane ee One RS et con ow 


Accounting User Classes - is used to specify 
an accounting user's class for each account. 
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Examples: 


In the following example, the privileges of a single account are 


listed. 
PRIV 1000 
ACT NAME PRIV 
1000 DEPT 2 8000F800 


In the following example, the privileges of a range 
are changed to the default privileges. 


PRIV 200-1000, * 


ACT NAME PRIV 

201 308503154TEMP SHOBER OOOO0A800 
211 308503154TEMP SHOBER OOO0A800 
230 035713087CAROL CARCH OOO0A800 
1000 DEPT 2 O0000A800 


In the following example, the privileges of an 
changed. 


PRIV 1000,FFFFFFFF 
ACT GRP NAME PRIV 
1000 250 . DEPT 2 FFFFFPFFF 
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of accounts 


account are 


3.4.10 TOTAL Command 


The TOTAL command generates a report to the list device or resets 
the values in the signon time used and processor time used fields 


to O. 

Format: 
TOTAL (Cc ] 

Parameter: 


Cc is an alphabetic character specifying that the 
signon time and processor time used fields are 
to be cleared or reset to 0, and no report is 
to be generated to the list device. If this 
parameter is omitted, a report is generated to 
the list device and no values are cleared or 
reset to 0. 


Functional Details: 


The generated report lists each active account. The following 
details concerning each account are displayed: account number, 
group number, signon time left, processor time left, and the 
processor and signon time used since the last report was 
generated. 
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GRP NAME 


1035213065DCF GROUP 
18030503089DC CONSULTA 
1035213065CHUCK PECK 
18031183089B0B DOMITZ 
18031183089WILL ETZ 
200357030850S32MT GROU 
1035213065CHRIS ARCHE 
180362430870S53 
18030493086N SHKOLNIKO 
20032453088ADMINISTRAT 
18032373086RANDEE HAFT 
20031543085PETE HORN 
1035203065JOHN GRAY 
96036243087LANCE PATTI 
18031203089SUE SELBY 
1035203065BILL DEIBLE 
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TIME LEFT 


x* 
x 
xx 
xk 
xk 
xx 
xk 
xk 
xx 
Kx 
“x 
xk 
xx 
xx 
xx 
x* 


PROCESSOR 
TIME LEFT 


xx 
xx 
xx 
aK 
xx 
xx 
xx 
xx 
xx 
xx 
xx 
xx 
xk 
xx 
xk 
xx 


PRIV 


0000A800 
0000A800 
8000FCOF 
8000FCOF 
8000FCOF 
8COEFEOF 
8000FCOF 
FFFFFFFF 
8000FCOF 
8CDEFEOF 
8000FCOF 
8000FCOF 
8000FCOF 
8008FCOF 
8000FCOF 


8000FCOF 


TIME USED 


COOOCOOONTO0OC0O0OV7O00 


PROCESSOR 
TIME USED 


oog0o000rF0 00 00W000 


CHAPTER 4 
0S/32 ACCOUNTING FACILITY 


4.1 INTRODUCTION 


The OS/32 Accounting Facility is a software feature that is 
optionally specified at OS/32 system generation (sysgen). This 
facility provides the user with management information for 
computer center operation. Information is collected on the basis 
of account numbers) and user identifiers (userids), and is 
reported as a formatted summary on user-selected account numbers 
and time periods. The collected information includes such items 
as processor (PRC) time, auxiliary processing unit (APU) time, 
size of a task's segments, elapsed time, roll time, wait time, 
input/output (1/0) counts to [/O devices, and system space usage. 
Because data collection is performed by the operating system and 
the multi-terminal monitor (MTM), an operating system and MT 
sysgen are required and should be consistent for both. 


Tne Accounting Facility is composed of two parts: 


@e Data collection 


@ Reporting Utility 


Data collection is performed by the operating system and MTM 
through counting, collecting and logging routines, which together 
collect and store the accounting information in a user-specified 
disk file called the accounting transaction file (ATF). 


The Reporting Utility is a utility program that selects) and 
transfers accounting information to a printer, disk file or tape 
file. Through operator-specif ied commands, accounting 
information can be used to produce cost distribution, billing, 
control and information reports. See the OS/32 Systems Support 
Utilities Reference Manual. 
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4.2 SYSTEM REQUIREMENTS 


The Accounting Facility requires these system components: 


@e Perkin-Elmer 32-bit processor 

e 256kb memory 

e OS/32 RO7.2 software release or higher 
e Accounting support at 0S/32 sysgen 

e Accounting support at MTM sysgen 

e Disk device 

@e Print device 


e Temporary files 


4.2.1 0S/32 System Generation (Sysgen) 


The Accounting Facility is included in the OS by specifying the 
sysgen ACCOUNTING and [OCLASS configuration input commands. See 
the OS/32 System Generation (Sysgen/32) Reference Manual. 


4.2.2 Multi-Terminal Monitor (MTM) System Generation (Sysgen) 


The Accounting Facility is included in MTM through the parameter 
specified for the OS/32 Accounting Facility option (SGN.ACT) at 
MTM sysgen as described in Chapter 2. 


4.2.3 Accounting Transaction File (ATF) 


The ATF contains records for all activities performed by each 
account. The information processed by the Reporting Utility is 
provided by the ATF. The ATF is created by MTM through the ATF-= 
parameter of the MTM START command (see Chapter 5). The ATF can 
also be changed by MTM through a parameter in the .MTM operator 
commana. When the command .MTM ATF file descriptor (fd) is 
entered, the current ATF is closed and a new ATF is opened. This 
allows data collection to continue on the new ATF while the 
Reporting Utility processes the accounting data in the old ATF. 
If a new ATF is not opened, an assignment error is displayed and 
data can no longer be collected. 
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4.3 LINK OPTION 


Accounting support can be enabled or disabled for tasks through 
an optional parameter in the Link OPTION command (see the 0S/32 
Link Reference Manual). 


4.4 STARTING DATA COLLECTION 


After operating system and MTM sysgens with accounting support 
have been performed, MTM is started as described in Sections 5.2 
and 5.3. Data collection is started by specifying the ATF- 
parameter of MTM START command. 


4.5 DATA COLLECTION 


The OS/32 Accounting Facility collects data for each account. 
All collected data is stored in the appropriate ATF records on 
the basis of a job or task. Job-related data is collected on the 
total number of tasks submitted as one job. Task-related data is 
collected on a single task. Job- and task-related data are 
collected and stored in specific categories which are explained 
in the following sections. 


See Appendix D for ATF record formats. 


4.5.1 Accounting Date and Time Formats 


Accounting dates are specified and displayed by MIM in these 
formats: 


mm/dd/yy is the month, day and year displayed on the 
terminal user's console when the terminal user 
signs off the system. 


mon/dd/yy is the month (three alphabetic characters), 
day and year specified in the Reporting 
Utility SELECT, OPTION and REPORT commands 
(see the OS/32 System. Support Utilities 
Reference Manual). 


dd/mon/yy is the day, month (at least three alphabetic 
characters) and year specified in the 
Reporting Utility SELECT, OPTION and REPORT 
commands (see the OS/32 System Support 
Utilities Reference Manual). 
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Accounting times are displayed by MTM in these formats: 


a. hh:mm:ss 


is the hours, minutes and seconds of 
elapsed time, task elapsed time, 
signon time left or signoff time. 


b. hh:mm:ss.ms pp.p% is the hours, minutes, seconds, 


milliseconds (ms) and percentage of 
total elapsed time of user central 
processing unit (CPU) time, wait 
time, roll CPU time, supervisor call 
(SVC) CPU time, total processor time 
or total processor time left. In a 
Model 3200MPS System, the user APU 
time is displayed in this format. 


The following displayable accounting times and their formats are 
specified: 


user CPU time 


SVC CPU time 


roll CPU time 


user APU time 


processor time 


task elapsed 
time 


signoff date 
and time 


elapsed time 


total task 
elasped time 


total 
processor 
time 


is the CPU time spent directly by the user 
task; format b. 


is the CPU time spent for SVCs on behalf of a 
user task; format b. 


is the CPU time spent to roll the user's task; 
format b. 


is the APU time spent by the user task (on 
Model 3200MPS only); format b. 


is the total processor time spent by or _ on 
behalf of the user task (= user CPU + SVC CPU 
+ roll CPU + user APU); format b. 


is the time between start and end of task; 
format a. 


is the date and time, in the appropriate 
format, of the terminal session or batch job 
signoff; format a. 


is the time between signon and signoff for 
a terminal session or batch job; format a. 


is the task elapsed times accumulated between 
signon and signoff for a terminal session 
or batch job; format a. 


is the processor time accumulated between 


signon and signoff for a terminal session or 
batch job; format b. 
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signon time 
left 


processor time 
left 


is the amount of time left for the terminal 
user or batch job out of the allocated limit; 
format a. 


is the amount of processor time left for the 
terminal session or batch job out of the 
allocated limit; format b. 


4.5.2 Terminal Session or Batch Job Accounting Data 


The accounting data collected for each terminal session or batch 


job processed is: 


e Elapsed time 


@e Signon and signoff date and time 


e Job number 
e Date and time a 
e Total number of 


e Total number 
executed 


@ Total number of 


job is submitted 


tasks run 


of command substitution system (CSS) calls 


commands entered 


e Total number of DISPLAY FILES commands entered 


e User identifier 


(userid) 


@e Renamed and deleted files 


e Account number 


All job-related accounting data is described in the following 


sections. 


4.5.2.1 Elapsed Time 


Elapsed time is the amount of time that passes between signon and 
signoff for a particular terminal session or batch job. Elapsed 


time is displayed 


aS a message on the terminal user's console or 


batch log device each time the terminal user or batch job signs 


off: 


ELAPSED TIME = 
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elapsed time 


4.5.2.2 Signon and Signoff Date and Time 


The signon and signoff dates and times indicate the dates’ and 
times that the terminal user or batch job signs on and off the 
system. These dates and times are collected and stored as 
hexadecimal numbers in the ATF signon and signoff account 
records. Signon and signoff times are collected and stored in 
the ATF signon and signoff account records as the current time to 
the nearest minute. 


The signoff date and time are displayed as a message on the 
terminal user's console or batch log device each time the 
terminal user or batch job signs off. 


TIME OFF = signoff date and time 


4.5.2.3 Job Number 


The job number is a hexadecimal number assigned to a job 
consisting of one or more tasks. This number is collected and 
stored in the ATF signon, signoff and task completion or data 
overflow account records. 


4.5.2.4 Date and Time a Job is Submitted 

The date and time a job is submitted to the batch queue is 
collected and stored as a hexadecimal number in the ATF signon 
account record. 

4.5.2.5 Total Number of Tasks Executed 

The total number of tasks executed as part of a batch job or 


during a terminal session is collected and stored as a 
hexadecimal number in the ATF signoff account record. 


4.5.2.6 Total Number of Command Substitution System (CSS) Calls 
Executed 

The total number of CSS calls executed by a batch job or during 

a terminal session is collected and stored as a hexadecimal 

number in the ATF signoff account record. 

4.5.2.7 Total Number of Commands Entered 

The total number of commands entered in the system by a batch job 


or during a terminal session is collected and stored as a 
hexadecimal number in the ATF signoff account record. 
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4.5.2.8 Total Number of DISPLAY FILES Commands Entered 

The total number of DISPLAY FILES commands entered in the’ system 
by a batch job or during a terminal session is collected and 
stored as a hexadecimal number in the ATF signoff account record. 
4.5.2.9 User Identifier (Userid) 

The userid, with which the terminal user or batch ‘job signs’ on 
the system, is collected and stored in the ATF signon, signoff 
and task completion or data overflow account records. 

4.5.2.10 Renamed and Deleted Files 

Data pertaining to files that are renamed or deleted is collected 
and stored in the ATF renaming or deletion account records. This 
data consists of the: 

@ Date and time the file was created 

e Current fd 

@e Number of sectors in the file 

@e Date and time the file was renamed 


e@ New fa 


@ New account number to which the file was assigned 


4.5.2.11 Account Number 

The account number with which the terminal user or batch job 
signs on. the system is collected and stored in all the ATF 
account records. 


4.5.3 Task-Related Accounting Data 


The accounting data collected for each task processed is: 


@ User CPU time, SVC CPU time and roll CPU time 
e User APU time (Model 3200MPS System only) 

@® Roll time 

e Wait time 


e Date and time a task started and terminated 
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e Userid 

@ Memory used 

e Count of I/O transfers to I/O devices 

@ Roll count 

e fd from which a task was loaded 

@® User-supplied information 

e Account number 

e Job number 

e End of task code 

All task-related accounting data is described in the _ following 
sections. 

4.5.3.1 Processor (PRC) Time 

Processor time is collected and stored in the ATF task completion 
or data overflow account records as a number of 100ms increments. 
All processor time is collected and stored in the _ following 
categories: 

e User CPU time 

e svc CPU time 

@e Roll CPU time 

e User APU time 

User CPU time is the amount of CPU time spent executing user code 
and nonreentrant system code. SVC CPU time is the amount of CPU 
time spent executing reentrant system code on behalf of the user. 
Roll CPU time is the amount of CPU time spent rolling a task into 
memory . User APU time is the time spent executing user code on 
an APU in a Model 3200MPS System. Processor time (user CPU + 
user APU + SVC CPU + roll CPU) is displayed as a message on the 
terminal user's console or batch log device. The following 


message is displayed when a terminal user's task or batch job 
terminates: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-ELAPSED=task elapsed time 
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The following message is displayed when data overflow occurs: 


taskid-ACCOUNTING DATA RESET PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


The following message is displayed when the terminal user or 
batch job signs off: 


PROCESSOR=total processor time TSK-ELAPSED=total task elapsed time 


The user CPU, SVC CPU, roll CPU and user APU times can also be 
displayed by the DISPLAY ACCOUNTING command (see _ the 0S/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.2 Roll Time 


Roll time is the time a task spends waiting to execute because it 
was rolled out of memory. Ail roll time is collected and stored 
in the ATF task completion or data overflow account records as a 
number of 100us increments. Roll time can be displayed by the 
DISPLAY ACCOUNTING command (see the OS/32 Multi-Terminal Monitor 
(MTM) Reference Manual). 


4.5.3.3 Wait Time 


Wait time is the time a task spends waiting to execute because of 
a request that task issued for itself (e.g., I/O request). Wait 
time excludes all PAUSE requests and the time a task spends 
suspended by another task or by the terminal user. All wait time 
is stored in the ATF task completion or data overflow account 
records as a number of 100ms_ increments. Wait time can be 
displayed by the DISPLAY ACCOUNTING command (see the 058/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.4 Date and Time a Task Started and Terminated 

The date and time a task started and terminated is collected and 
stored in the ATF task completion or data overflow account 
records as a number of 100ms increments. 

4.5.3.5 User Identifier (Userid) 

The userid, with which the terminal user or batch job signs on 


the system, is collected and stored in the ATF signon, signoff 
and task completion or data overflow account records. 
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4.5.3.6 Memory Used by a Task 


The total amount of memory used by a task during execution is 
collected and stored in the ATF task completion or data overflow 
account records as the number of 256-byte segments. Memory used 
is collected and stored in three categories: 


e Impure segment space 
e Shared segment space 


e System space 


Impure segment space is the maximum amount of impure memory used 
by a task during execution. Shared segment space is the maximum 
amount of shared memory (i.e., pure, TCOM, RTL) used by a task 
during execution, and system space is the maximum amount of 
system space used by a task during execution. 


4.5.3.7 Count of Input/Output (1/0) Transfers to I/O Devices 


All I/O transfers (read, write, test and set) made to an “I/O 
device assigned to a particular device class are counted, 
collected and stored as a hexadecimal number in the ATF task 
completion or data overflow account records. These numbers are 


stored in the appropriate class category in the ATF. Each 1/0 
class supported by the Accounting Facility occupies eight bytes 
in each ATF account record. The number of bytes transferred 


every time an I/O transfer occurs is counted and stored as a 
hexadecimal number in the ATF. The count of I/O transfers can be 
displayed by the DISPLAY ACCOUNTING command. I/0 transfer limits 
are established at MTM sysgen time by the IOTAB or UIOLIM macros 
(see Chapter 2) and can be overridden by the terminal user for 
batch jobs through the SIGNON command (see the  OS/32 
Multi-Terminal Monitor (MTM) Reference Manual). 


4.5.3.8 Roll Count 


Roll count is the total number of times the impure segment of a 
task is rolled into memory. The roll count is collected and 
stored as a hexadecimal number in the ATF task completion or data 
overflow account records. The roll count can be displayed by the 
DISPLAY ACCOUNTING command (see the OS/32 Multi-Terminal Monitor 
(MTM) Reference Manual). 
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4.5.3.9 File Descriptor (fd) from Which a Task Was Loaded 


Every time a task is loaded, the fd from which it was loaded is 
stored in the ATF task completion or data overflow account 
records. This data aids the user in determining which’ system 
tasks are used more often, and whether they should be made 
resident or nonresident. 


4.5.3.10 User-Supplied Information 


User-supplied information is eight bytes of data supplied by’ the 
terminal user through the SETACCT macro. This information is 
stored in the ATF task completion or data overflow account 
records (see the OS/32 System Macro Library Reference Manual). 


4.5.3.11 Account Number 


The account number, with which the terminal user or batch job 
signs onto the system, is collected and stored in all ATF account 
records. 


4.5.3.12 Job Number 


The job number, to which a particular task is assigned, is 
collected and stored in the ATF’ signon, signoff and task 
completion or data overflow account records. 


4.5.3.13 End of Task Code 


The end of task code, with which each task terminates, is 
collected and stored in the ATF task completion or data overflow 
account records. The code is displayed on the terminal user's 
console or batch log device each time a user's task or batch job 
terminates: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


If a task exceeds the processor time limit, the end of task code 
1200 is displayed when the task terminates. If a task exceeds 
the 1/0 transfer limit, the end of task code 1210 is displayed 
when the task terminates. 
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4.6 TERMINAL USER ACCESS TO ACCOUNTING INFORMATION 


A terminal user can access accounting information: 


@e at task termination, 
e when a task control block (TCB) counter overflow occurs, 
e at signoff time, 


e through the DISPLAY ACCOUNTING command (see the 0S /32 
Multi-Terminal Monitor (MTM) Reference Manual), or 


e through the fetch accounting information (FETACCT) macro (see 
the OS/32 Multi-Terminal Monitor (MTM) Reference Manual). 

4.6.1 Task Termination 

When a terminal user's task or batch job terminates execution, 


accounting information is displayed on the terminal user's 
console or batch log device in this message: 


taskid-END OF TASK CODE=xxxx PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


4.6.2 Task Control Block (TCB) Counter Overflow 


When the counters for data collection in the TCB overflow, this 
accounting information is displayed on the terminal user's 
console or batch log device in this message: 


taskid-ACCOUNTING DATA RESET PROCESSOR=processor time TSK-ELAPSED=task elapsed time 


4.6.3 Signoff Time 


When a terminal user or batch job signs off the system, 
accounting information is displayed to the terminal user's 
console or batch log device in these messages: 


ELAPSED TIME=elapsed time PROCESSCR=total processor time TSK-ELAPSED=total task elapsed time 


SIGNON LEFT=signon time left PROCESSCR LEFT=processor time left 
TIME OFF-signoff date and time 


If there are no signon or processor time limits set for the 
account, SIGNON LEFT= anc PROCESSOR LEFT= are not displayed at 
signoff. 
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CHAPTER 5 
MULTI-TERMINAL MONITOR (MTM) OPERATING PROCEDURES 


5.1 INTRODUCTION 

Before loading and starting MTM, an authorized user file (AUF) 
must already exist (see Chapter 3). The commands used to load, 
establish, start and control MTM are presented in this chapter. 
5.2 LOADING AND ESTABLISHING THE MULTI-TERMINAL MONITOR (MTM) 
The following two commands load and establish MTM as the current 
task: 


Formats: 


LOAD .MTM,fa 


TASK .MTM 
Parameter: 


fd is the file descriptor of the device from 
which MTM is loaded. 


Functional Details: 


The priority of MTM is established when MTM is linked. To ensure 
that MTM is not at the same level as the real-time system, MTM 
should be set at a priority lower than the lowest priority of 
real-time tasks in the operating system. If MTM is set at a 
lower priority, it executes as a background system. Since MTM is 
almost totally input/output (1/0) bound, it does not interfere 
with other tasks. Tasks executing in an MTM environment will run 
at a maximum priority of one less than the priority of MTM. 
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5.3 


START COMMAND 


The START command starts MTM. Parameters for the START command 
may be specified in any order. 


Format: 


START ,AUF=fd Latr=fd] [, TERMINAL=(f4, [fa2,-..,fdn]}) | 


E BATCH=(n, fa) | [, RAGE=fd | 


Parameters: 


AUF = 


ATF = 


TERMINAL= 


BATCH= 


fd is the file descriptor of the AUF. This 
file must reside on account 255. The 
Authorized User Utility must be used to create 
the AUF prior to running MTM. This parameter 
is required. 


fd is the file descriptor of the accounting 
transaction file (ATF). The ATF accumulates 
accounting data in systems with accounting 


support. If the indicated file exists, 
records are appended. If it does not exist, 
MTM automatically allocates it: This 


parameter must be specified if the operating 
system is generated with accounting support. 
A user who does not wish to retain accounting 
information can specify ATF=NULL. 


fd is the file descriptor of the terminal 
devices that MTM is to monitor. Up to 64 
terminal fds can be specified. If the command 
line entered exceeds one line, specify 
additional terminal devices with the .MTM ADD 
command . 


mn is a decimal number from 1 to 64 indicating 
the number of concurrent batch streams that 
MTM can start. 


fd is the file descriptor of the batch queue. 
The batch queue is an indexed file containing 
fds of the batch streams to be processed. If 
the fd specified does not exist, MTM allocates 
the file. 
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PAGE= © fd is the file descriptor of the page file 
used by local and global variables. If this 
parameter is omitted, MTM automatically 
allocates a file’ named PAGE on the system 
volume, account 255. 


Functional Details: 


The number of concurrent batch streams allowed, plus the number 
of terminals to be monitored, cannot exceed the maximum number of 
users allowed (NUSERS) at MTM system generation (sysgen). 


MTM can optionally load and start an assistant task (which runs 
under the task name .MTMASST). An assistant task executes a 
supervisor call 7 (SVC7) on behalf of MTM. This task can improve 
MTM response time because MTM does not have to wait while an SVC7 
is in progress. 


When started, MIM tries to load and start the assistant task. 
MTM assumes that the assistant task image is on the file 
MTMASST.TSK on the system volume. If this file does not exist, 
or if the load fails, MTM is not affected. However, MTM issues 
its own SVC7 calls and response time is slower. 


Because the operating system cancels all subtasks when the 
monitor task goes to end of task, .MTMASST is also cancelled when 
MTM goes to end of task. If an attempt is made to restart MIM, 
MTM goes to end of task 254. 


When MTM is started from a command substitution system (CSS) 
file, and an .MTM command immediately follows the START command, 
an SVC6-ERR TYPE=QUE POS=.MTM error may occur. This error 
results if the MTM task has not completed initialization when the 
-MTM command is entered. To avoid this problem, put time delay 
commands such as $WAIT 2 between the START and .MTM commands. 


Example: 
This command starts MTM using an AUF named ACCTS.32/255 and an 
ATF named ATF./255. Three terminals are to be monitored. Four 


batch jobs may run concurrently, and the file BATCH.Q is assigned 
as the batch queue. 


ST,AUF=ACCTS .32,ATF=ATF,T=(CR10:,CR12:,CR14:),B=(4,BATCH.Q) 
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5.4 .MTM COMMAND 
The .MTM command enables the system operator to control MTM, its 
terminals and users from the system console. 


Format: 


WAIT 
TERMINAL 


STATUS | ,4 BATCH 


USED [,fd;] 


MESSAGE 


jusersa message 


BROADCAST message 


device: 
ADD 
BATCH n [ fd] 


- MTM TERMINATE device: 


devices) 


> 


REMOVE 
BATCH nJ 


QUIESCE 

PURGE fd 

INQUIRE [fd | 

SUBMIT fd 

ATF fd 
INTERVAL n, 

PSM |4 1/0 no 
MAXPROCESSOR nj 
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Parameters: 


STATUS 


WAIT 


TERMINAL 


BATCH 


USED 


fd, 


TELL 
MESSAGE 


userid 


BROADCAST 
message 
ADD 


device 
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displays current information. If no _ further 
parameter is specified, information on 
terminal users and batch jobs is displayed. 


displays to the system console system 
resources available to MTM, the peak usage of 
system resources, and the number of times 
users had to wait for resources to become 
available. 


indicates that terminal information is to be 
displayed. 


indicates that batch information is to be 
displayed. The number of batch streams. that 
can run concurrently is also displayed. 


displays in histogram form the number of times 
a command buffer was used during MT 
execution. See Figure 5-1 for an example of 
a listing output by the USED parameter. 


specifies the file or device to which the 
output from the USED parameter is sent. If 
fd; is omitted, the system console is’ the 
display device. 


displays a message on a specified user 
terminal. 


displays a message on a specified user 
terminal. 


identifies the terminal user. 


displays a message on all terminals whether or 
not they are in use. 


is a l- to 62-character alphanumeric” string 
indicating the message to be broadcast. 


adds an additional terminal or concurrent 
batch to the MTM system. 


is the new terminal to be added. The total 
number of terminals supported by MTM must not 
exceed NUSERS (number of batch streams). 


BATCH n 


fd 


TERMINATE 


device 


REMOVE 


device 


BATCH n 


QUIESCE 


is the number of additional concurrent batch 
streams to be allowed. The total number of 
concurrent batch streams supported by MTM must 
not exceed NUSERS (number of terminals). This 
parameter increases the number of allowable 
concurrent batch streams supported by MTM but 
does not add batch streams to the batch queue. 
To add batch streams to the batch queue, use 
the SUBMIT command. 


specifies the file descriptor of the batch 
queue file. If a batch queue currently 
exists, this parameter is ignored. 


immediately cancels a terminal user's task and 
signs off a terminal user. This parameter 
does not affect batch jobs. 


is the terminal to which the user to be 
terminated is signed on. 


stops MTM from accepting commands at a 
specific terminal or reduces’ the number of 
allowable concurrent batch jobs. 


is the terminal to be removed. If the 
terminal is currently in use, the terminal 
user is allowed to continue until a SIGNOFF 
command is entered. When the terminal is 
removed, MTM closes the logical unit (lu) 
assignment for the terminal. 


is the number of concurrent batch streams’ to 
be removed. Currently active jobs are allowed 
to complete execution. If n is greater than 
the number of current batch streams, the 
number of concurrent batch streams supported 
by MTM is reduced to zero. If the new number 
of batch streams is less than the number of 
currently active batch jobs, the extra batch 
jobs are allowed to go to completion. 


terminates MTM; new signons are prevented and 
batch job initiation is stopped. When all 
terminal users sign off the system and ail 
currently active batch jobs terminate, MTM 
goes to end of task. Before MTM goes to end 
of task, information on the availability and 
usage of and the number of times users had _ to 
wait for system resources is output. If MTM 
discovers that command buffers are missing 
(the buffer chain has been broken), it pauses 
to allow user action (such as a panic dump). 
When the CONTINUE command is entered, MTM goes 
to end of task code 210. 
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PURGE 


fd 


INQUIRE 
fd 


SUBMIT 
fd 


ATF 


fd 


PSM 


INTERVAL 


n 


T/O 


MAXPROCESSOR 
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removes a batch job from the system and from 
the batch queue. If the batch job is 
currently active, it is cancelled. 


is the file descriptor of the file containing 
the batch job. 


displays the status of a batch job. 


is the file descriptor of the file containing 
the batch job. If fd is omitted, the status 
of all submitted jobs is displayed. 


adds a job to the batch queue. 


is the file descriptor of the file containing 
the batch job to be added to the batch queue. 


changes the accounting transaction file. The 
current ATF is closed and a new ATF is 
allocated (if necessary) and assigned. 


is the file descriptor of the new ATF. 


indicates that this command is directed to the 
priority scheduling mechanism (PSM) handler 
within MTM. If no further parameter is 
specified, the current PSM values are 
displayed on the system console. This 
parameter is legal only if SGN.SCHR (see 
Section 2.4.21) is equated to 2 when sysgening 
MTM. 


selects the interval value for change. 

is the time interval in seconds between the 
PSM priority recomputation. The range for 
n is 1 through 10. 

selects the I/O count for change. 

sets the maximum number of I/O (performed in 


the last PSM interval) that is taken into 
account to recompute the new priority for an 


MTM subtask. Tasks with I/O intensity 
exceeding this value (in the last PSM 
interval) are treated as if their I/O 


intensity equals the value. The higher’ the 
I/O intensity of a task, the higher its 
computed priority. The range for n is 1 
through 9,999. 


selects the MAXPROCESSOR value for change. 


ee eee ee coe ee ees oe 


n Specifies task maximum processor time as a 
fraction of the PSM interval. If an MTM 
Subtask uses more than this value of processor 
time (in the last PSM interval), its priority 
is reset to the lowest PSM priority. 


Functional Details: 


-MTM STATUS,WAIT, .MTM QUIESCE and .MTM STATUS,USED can be used 
to determine if the numbers specified at MTM sysgen for command 
buffers (NCSBFS), console buffers (NCONBFS), sector buffers 
(NSECTS) and logical units (LINKOPT) are optimal. Increasing the 
available resources at MTM sysgen can help to eliminate excessive 
wait conditions. Decreasing resources can eliminate unnecessary 
memory overhead. 


The new PSM values are displayed after each command to the system 
console. The defaults set up at the start of MTM are as follows: 


Interval n = 4 sec / I/O n = 500 / MAXPROCESSOR n = 253% 


These values can be adjusted for a particular environment. It is 
advisable to decrease the PSM interval value in a volatile 
environment where task I/O and/or computation intensity changes 
rapidly and increase the value in a stable environment to reduce 
the scheduling overhead. 


The PSM I/O intensity limit must be set so that highly I/o 
intensive tasks do not monopolize the resources. The priority of 
the task is evaluated as an empirical function of the ratio 
between the task's I/O intensity and computation intensity. The 
greater the I/O intensity is and the lesser the computation 
intensity is, the higher the priority is. Setting the PSM I/O 
value prevents the tasks with an abnormally high I/O intensity 
from gaining the highest priority and causing frequent 
pre-emption of other tasks. 


The PSM MAXPROCESSOR value must be set so that highly computation 
intensive tasks do not monopolize the resources. Setting the PSM 
MAXPROCESSOR value ensures that tasks with an abnormally high 
computation intensity get the lowest possible priority. 


Examples: 
Sample output from the .MTM STATUS command: 


-MTM STA 

~MTM: TERMINAL USERS - 

-MTM: 0S832-BATCH >MTM-MODE 0S3220-BATCH >MTM-MODE 

-MTM: ROD-CT4C: >MTM~MODE RICH-CT7A: @MTM-MODE 

-MTM: JOB M300:0S832.J0B/96 EXECUTING USER ID=0S832 
-MTM: JOB M300:0S3220.J0B/96 EXECUTING USER ID=0S3220 
~MTM:WAITING JOBS = 1 

-MTM: 2 BATCH STREAMS 
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Sample output from the .MTM STATUS,WAIT command: 


-MTM STA,W 

-MTM: TOTAL PEAK CURRENT WAITS 

-MTM: 42 32 29 0 CMD BUFFERS 

~-MTM: 0 0 0 0 CON BUFFERS 

-MTM: 7 4 0 0 SEC BUFFEFS 

-MTM: 50 10 6 0 LU 

Where: 

TOTAL indicates the maximum number available. 

PEAK indicates the maximum number concurrently 
used. 

CURRENT indicates the number in use at the time the 
command was executed. 

WAITS indicates the number of times users’ were 


placed in a wait state. 


Sample output from the .MTM STATUS,TERMINAL command: 


-MTM STA,T 

-MTM: TERMINAL USERS - 

~MTM:0S832-BATCH>MTM-MODE 0OS3220-BATCH >MTM-MODE 
»MTM: ROD-CT4C: >MTM~MODE RICH-CT7A: @MTM-MODE 


Sample output from the .MTM STATUS,BATCH command: 


-MTM STA,B 

-MTM: JOB M300:0S832.J0B/96 EXECUTING USER ID=0S832 
-MTM:JOB M300:0S83220.J0B/96 EXECUTING USER ID=0S3220 
~-MTM:WAITING JOBS = 1 

-MTM: 2 BATCH STREAMS 


This .MTM STATUS,USED command displays, in histogram format, the 
number of times the indicated number of command buffers were used 
concurrently. Figure 5-1 indicates, for example, that four 
command buffers were concurrently used three times, 12 were 
concurrently used 90 times and 24 were concurrently used 900 
times. 
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Figure 5-1 Sample Output from the .MTM STATUS,USED Command 


The .MTM TELL and .MTM MESSAGE commands” send the indicated 
message to the terminal signed on with a userid of SAM. 


-_MTM TEL SAM, YOUR MAG TAPE IS MOUNTED. 


.MTM ME SAM, YOUR MAG TAPE IS MOUNTED. 


The .MTM BROADCAST command sends the indicated message to all 
terminals currently assigned to MTM. 


-MTM BRO MTM IS GOING DOWN IN 15 MINUTES. 
This .MTM ADD command adds the device CRT2: to MTM.. 
-MTM ADD CRT2: 


This .MTM ADD command increases the number of batch streams 
allowed by 2. 


-MTM ADD BATCH 2 


This .MTM TERMINATE command terminates the user signed onto 
CRT8:. 


-MTM TER CRTS8: 


This .MTM REMOVE command removes CRT10: from MTM upon the next 
sign off command. 


.MTM REM CRT10: 


This .MTM REMOVE command decreases the number of batch streams 
allowed by 3. 


.MTM REM BATCH 3 


The .MTM QUIESCE command terminates MIM after all users have 
signed off and all batch jobs have terminated. 
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The following table is output prior to MTM termination. 


~-MTM QUIESCE 
~-MTM: TOTAL PEAK CURRENT WAITS .MTM: 42 32 29 0 CMD BUFFERS 


~MTM: 0 0 0 0 CON BUFFERS .MTM: 7 4 0 0 SEC BUFFERS .MTM: 50 
10 6 0 LU .MTM END OF TASK CODE 0 


The .MTM PURGE command cancels the indicated batch job if active, 
Or removes it from the batch queue if not active. 


-MTM PUR MT30:TEST.JOB/8 


The .MTM INQUIRE command displays the status of all submitted 
jobs. 


-MTM INQ 

-MTM:JOB M300:0S832.J0B/96 EXECUTING 
-MTM:JOB M300:0S3220.J0B/96 EXECUTING 
-MTM:JCB M300:0S3230.J0B/96 WAITING 


This .MTM INQUIRE command displays the status of the specified 
job. 


-MTM INQ FRED: TASK.JOB/18 JOB FRED: TASK.JOB/18 NOT FOUND 


The .MTM SUBMIT command adds the specified job to the batch 
queue. 


-MTM SUB MT30:TEST.JOB/8 


This example selects an I/O count of 335 and the following 
information is returned: 

~MIM PSM I/O 335 

10:02:20 .MTM:CURRENT PSM: INTERVAL=04 SEC I/0=0335 MAXPROCESSOR=25 % 
5.5 MULTI-TERMINAL MONITOR (MTM) END OF TASK CODES 

With the exception of end of task codes 0 and 255, MTM goes to 


end of task due to ae situation that it cannot resolve. The 
format of the end of task message on the system console is: 


~MTM END OF TASK CODE nnn 
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The MTM end of task codes and meanings are listed in Table 5-1. 


TABLE 5-1 MTM END OF TASK CODES 


ees CrR care Grew Gov Cammy ENE ne OY Ot EF Goes Mane Ge Ge Ghee Ge See GAS Game EF ew CEE Get Ge BEF Gee EL Gee Ge Gs Get Ft Ee Ge Gs Ge Oe ES GT RD Mee Ee DEO SEE ST ee ee Ge ne Be ee ee ee ee ee ee ee OS Oe eT ed ee 


| CODE | MEANING | 
| 0 | Indicates normal end of task. | 
| | | 
| 1 | Indicates no message buffers. | 
| | | 
| 2 | Illegal entry was removed from the task queue. | 
| | | 
| 3 | The task has just been loaded but its task control | 
| | block (TCB) cannot be located. | 
| | 
| 4 | An SVC6 error has occurred, but the error is not | 
| | listed in the error table. | 
| | | 
| 6 | .MTM START parameter(s) is wrong. | 
| | | 
| 7 | A command buffer length of less than 72 or NUSERS less | 
| | than 1 was specified. | 
| | | 
| 8 | The address for the device mnemonic table (DMT) in the | 
| | volume mnemonic table (VMT) is 0 for a direct access | 
| | volume. a 
| | | 
| 9 | A read or write request was made to record 0 in the | 
| | batch queue; this request is illegal. | 
| 7 | 
| 11 | The number of I/O classes in the operating system is | 
| | larger than those in the MTM sysgen. | 
| | | 
| 12 | MTM could not assign the system console. | 
| | | 
| 200 | The priority scheduling mechanism (PSM) was specified | 
| | without accounting support. | 
| | | 
| 210 | Command buffers are missing upon .MTM QUIESCE (the | 
| | buffer chain is broken). | 
| | | 
{| 254 | A user attempted to restart MIM; MTM is not a | 
| | restartable task. | 
| | | 
| 255 | MTM has been cancelled. | 


ee eee ee ek ee SY OS Nk Ge a NS es ee es SR ee ee Ge ee ee ee ae OS ee ee OE ee ee ee OEE ee Gee Gee Gee Get Ome OS Ges Ge Oh) ED OF Om Ore On OS Em em 
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5.6 MULTI-TERMINAL MONITOR (MTM) ERROR MESSAGES 


The following error messages are generated on MT. 


BATCH ASGN-ERR TYPE=ASGN JOB=fd/act 


indicates the lu was not assigned when trying to assign 


a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=BUFF JOB=fd/act 


indicates system space was insufficient to obtain a 


file 


control block (FCB) when trying to assign a file at the 


start of a batch job. 


BATCH ASGN-ERR TYPE=FUNC JOB=fd/act 


indicates an invalid function was detected for 


a 


specified device/file when trying to assign it at the 


start of a batch job. 


BATCH ASGN-ERR TYPE=I/0O JOB=fd/act 


indicates an I/O error was detected on a_ specified 


file 


when trying to assign the file at the start of a batch 


Job. 


BATCH ASGN-ERR TYPE=lu JOB=fd/act 


indicates an illegal or unassigned lu was’ detected 
trying to assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=NAME JOB=fd/act 


indicates a mismatched filename.ext was detected 
trying to assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=PRIV JOB=fd/act 


indicates a mismatched access privilege was detected 
trying to assign a file at the start of a batch job. 


BATCH ASGN-ERR TYPE=SIZE JOB=fd/act 


indicates erroneous record length/size was detected 
trying to assign a file at the start of a batch job. 
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when 


when 


when 


when 


BATCH ASGN-ERR TYPE=VOL JOB=fd/act 


indicates no such volume/device was detected when trying 
to assign a file at the start of a batch job. | 


BATCH NOT ACTIVE 


indicates MTM was started without a batch queue, and a 
batch request had been made. 


BATCH QUEUE ASGN-ERR 


indicates the batch queue specified in the START command 
could not be assigned. 


BATCH QUEUE I/O-ERR TYPE=DU- - ~-ALL BATCH REMOVED- - - 


indicates device unavailable was detected on batch queue. 


BATCH QUEUE I/O-ERR TYPE=EOF- - -ALL BATCH REMOVED- - - 
indicates an end of file (EOF) was detected on batch 
queue. 

BATCH QUEUE I/O-ERR TYPE=EOM- - -ALL BATCH REMOVED- - - 


indicates an end of medium (EOM) error was detected on 
batch queue. 


BATCH QUEUE I1/0O-ERR TYPE=PRTY- - -ALL BATCH REMOVED- - - 


indicates parity or a recoverable error was detected on 
batch queue. 


BATCH QUEUE I/O-ERR TYPE=UNRV- - ~ALL BATCH REMOVED- - - 


indicates an irrecoverable error was detected on batch 
queue. 


BATCH QUEUE LRECL-ERR 


indicates a batch queue given in the START command has an 
invalid record length of less than 40 bytes. 


CANNOT ASSIGN AUF FILE 


indicates that MTM cannot assign an AUF. 


48-023 FOO RO3 


xxxx CMD BUFFERS MISSING 
indicates that the number of command buffers specified by 
xxxx has been discovered to be missing upon .MTM QUIESCE. 
COMMAND BUFFER LENGTH LESS THAN 72 
indicates that a command buffer length of less than 72 
bytes or NUSERS less than 1 was specified. 
dev-I/O ERROR status USER TERMINATED 
indicates an irrecoverable error has occurred on a 
device; the error status returned is indicated as the 
status. MTM automatically signs off a user signed on to 
the device. 


EXTRANEOUS OPERANDS 


indicates an MTM command has too many operands. 


FILE DESCRIPTOR ERROR 
indicates the fd specified in the command is omitted or 
its format is incorrect. 

INVALID COMMAND 


indicates the MTM command entered is unrecognized. 


INVALID PARAMETER 
indicates a command has been entered with an invalid 
parameter or bad syntax or the device cannot be found. 
voln:MTMASST.TSK/S HAS WRONG REVISION LEVEL 
indicates that the revision level for .MTMASST is 
incorrect. Execution of the .MTMASST task is cancelled. 
voln:MTMASST.TSK/S NOT FOUND OR LOAD ERROR 
indicates that the .MTMASST task could not be executed 


because the MTMASST.TSK/S file could not be found, or an 
error occurred when the task was loaded. 
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NO BUFFER AVAIL FOR CMD 


indicates that all command and message buffers are full. 


START OPTIONS FORM-ERR 


indicates an invalid format in the START command. 


START OPTIONS PARM-ERR 


indicates an invalid START parameter. 


TERMINAL ASSIGN ERROR 


indicates an attempt to add a new terminal to the system 
has failed. The device is not recognized or not 
available. 


TERMINALS OR BATCH EXCEED MAXIMUM 
indicates the number of concurrent batch streams allowed 
exceeds 64, the number of terminals exceeds 64, or the 


number of batch streams and terminals exceed the NUSERS 
established at MTM sysgen time. 


USERID NOT FOUND 


indicates a current user has not been found with this 
identification. 


PSM NOT SYSGENED 


The entered command is rejected because the PSM was not 
system generated (sysgened). 


Affected commands: 
~-MTM PSM 
-MTM PSM INTERVAL 
~MTM PSM I/O 
-MTM PSM MAXPROCESSOR 
MISSING OPERAND 


The entered command has a missing operand. Reenter the 
command specifying a value for n. 


Affected commands: 
-MTM PSM INTERVAL 


-MTM PSM I/O 
-MTM PSM MAXPROCESSOR 
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CHAPTER 6 
MULTI-TERMINAL MONITOR (MTM) OPERATION IN A 
MODEL 3200MPS SYSTEM MULTIPROCESSING ENVIRONMENT 


6.1 INTRODUCTION 


When an MTM operates in a Perkin-Elmer Model 3200MPS System 
multiprocessing environment, an MTM subtask can be executed on 
any processor in the system. The terminal user can manually 
assign a task to a specific processor queue by: 


@e entering an OPTION LPU command after loading the task (see the 
OS/32 Multi-Terminal Monitor (MTM) Reference Manual), or 


e linking the task with the LPU= option (see the OS/32 Link 
Reference Manual). 


Whether or not the above methods enhance system performance 
depends upon the task load of the particular processor assigned 
to the task in relation to the task loads of other processors in 
the system. Since a single terminal user may not be familiar 
with the requirements of the entire MTM installation, he may be 
unable to choose the processor that will result in optimum system 
performance. An improper auxiliary processing unit (APU) task 
assignment may even inhibit system performance. 


To overcome the disadvantages of manual APU task queue 
assignment, Perkin-Elmer provides load leveling executive (LLE) 
software. This software supplies the MIM system administrator 
with an automatic method of APU task queue assignment that is 
designed to take full advantage of the multiprocessing 
capabilities of the Model 3200MPS System. LLE automatically 
directs MTM subtasks either to the central processing unit (CPU) 
ready queue or to APU queue 0 depending on the run-time behavior 
of these subtasks. The subtasks scheduling priority is 
calculated by the priority scheduling mechanism (PSM) embedded in 
MTM. 


Once activated, LLE forces all subtasks without the supervisor 
call 6 (SVC6) control privilege (see Section 3.4.9) to use 
logical processing unit (LPU) O and operates only on these 
subtasks. All LLE operations on the subtasks are transparent to 
the terminal user. 
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LLE also collects system related information and prepares 
Statistics displayed with the .MTM LLE DISPLAY command. 


This chapter describes the operation of the LLE software and the 
system administrator's responsibilities for initializing, 
controlling and optimizing LLE for optimum system performance. 


6.2 OPERATION OF THE LOAD LEVELING EXECUTIVE (LLE) 


MTM subtasks running in a Model 3200MPS System can be directed 
for execution to the CPU or an APU. Tasks that are directed to 
the CPU are organized into a special task scheduling queue called 
the CPU ready queue. Tasks directed to an APU are organized in 
one of the APU queues. For load leveling purposes, a CPU/APU 
shared queue called queue 0 is used. Queue 0 is serviced by all 
APUS assigned to queue 0 and the CPU; the CPU, however, will only 
service this queue when itsS own ready queue is empty. 


The task requests for operating system services (SVCs, fault and 
trap processing) are fulfilled on the CPU ready queue. Whenever 
a service is required by a task assigned to queue 0, the task is 
transferred (passed back) to the CPU ready queue. Upon service 
completion, the task is passed back to queue 0 by the operating 
system. The LLE minimizes the traffic between the two queues 
(APU/CPU thrashing) according to the task's run-time behavior. 

| Essentially, the computation-intensive tasks are directed to 

| Logical Processor Unit (LPU) 0, which is always mapped to APU 
queue 0. Tasks can now be executed by any processor in the 
system (thus achieving load leveling). The service-intensive 
tasks (e.g., input/output (I/0)-intensive) are directed to the 
CPU ready queue. 


LLE executes as a Subtask of MTM and has a taskid of .MTMLLE. 
MTM loads, starts and controls the LLE task via commands entered 
at the system console. The task priority of .MTMLLE is 10. Once 
LLE is started, it runs periodically at a PSM interval controlled 
by the system operator. 

6.2.1 Queue 0 Eligibility 

LLE employs a queue 0 eligibility algorithm to determine which 


MTM subtasks are to be directed to queue 0. Queue 0 eligibility 
of a task, E, is computed as follows: 


E = 100%* (P-NP*TP) /PM 
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Where: 


p is the task processor time (CPU and APU user 
time) during the last PSM interval. 


NP is the number of task transfers (passbacks) 
from APU to CPU during the last interval. 


TP is passback overhead time (i.e., an estimate 
of time spent by OS/32 to handle passback). 


PM is the maximum task processor time allowed in 
a PSM interval. 


If the above equation for E yields a negative value, E is set to 
0. For active tasks that did not obtain any processor time in 
the last PSM interval, the value of E calculated at the previous 
PSM interval is used. 


Hence, a task that consumed all of the processor time allowed in 
a PSM interval and had no passbacks during the last PSM interval 
is 100% queue 0 eligible for the next PSM interval. During a PSM 
interval, a task that uses 100ms of CPU and APU time and makes 15 
passbacks with an estimated lms of overhead each, will be 85% 
queue 0 eligible. 


6.2.2 Fixed Mode of Operation 


The Operator can establish a fixed mode of LLE operation via a 
~-MTM LLE ELIGIBILITY command (see Section 6.4). The eligibility 
threshold specified in this command means that the tasks with the 
eligibility value equal to or exceeding the threshold must be 
directed to queue 0 while the rest must be directed to the CPU. 


6.2.3 Dynamic Mode of Operation 


The operator can establish a dynamic mode of LLE operation via 
the .MTM LLE ELIGIBILITY command. Dynamic mode incorporates an 
algorithm, which, during every PSM cycle, evaluates a variable 
eligibility threshold attempting to load up (but not overload) 
the CPU, the fastest processor in the’ system. The tasks with 
eligibility value equal to or exceeding the threshold are 
directed to queue 0 while the rest are directed to the CPU. 
Specifically, the threshold is set so that the total processor 
time of LLE controlled tasks having eligibility value below the 
threshold, plus the CPU time consumed outside of LLE control (as 
measured in the last PSM interval), would amount to ae selected 
fraction of the PSM interval (currently 80%). 
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6.2.4 Error Termination 


During execution, the LLE task continually checks queue 0 to 
ensure that at least one APU is assigned to the queue. If no APU 
is assigned to queue 0, LLE goes to end of task after sending the 
following message to the system console: 


NO APU ASSIGNED TO QUEUE-LLE TERMINATES 


If execution of the LLE task terminates or iS suspended because 
of an error, MTM immediately discontinues communication with the 
task and informs the operator of LLE error status by sending a 
message to the system console. MTM then redirects all subtasks 
on queue 0 to the CPU ready queue. Until LLE is reactivated via 
an LLE control command, all MTM subtasks are started from the CPU 
ready queue. This process is entirely transparent to the MTM 
terminal user. 


6.3 OPTIMIZATION AND CONTROL OF LOAD-LEVELING 


The system operator is able to optimize load-leveling for a 
particular installation by controlling the following values: 


@e PSM interval length 


@e Maximum number of I/O operations allowed for a task during the 
PSM interval 


@ Maximum processor time allowed for a task during the PSM 
interval 


@e Queue 0 eligibility limit 


These values are displayed and changed using the .MTM PSM and 
-MTM LLE commands (see Sections 5.4 and 6.4). The decisions to 
change the above values are based on: 


@e Establishing criteria for load-leveling at the given 
installation; e.g., maximum system throughput with a limit on 
user response time, maximum speed of response with a limit on 
how low the system throughput can fall or minimum system 
overhead, etc. 
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e Sampling applicable accounting data to determine a favorable 
change of parameters upon varying the above values; e.g., 
increasing PSM interval length generally reduces overhead, but 
increases the response delay; increasing the next two values 
increases throughput for the I/0O- or computation-intensive 
tasks, respectively, but will decrease response time; increase 
of the eligibility limit lowers the passback overhead, but 
also decreases APU utilization, etc. 


The system operator is able to monitor and control LLE execution 
and initial task direction to the appropriate queue. This way 
the traffic optimization between the queues provided by the LLE 
is enabled or disabled and the initial task distribution is set. 
These functions are performed using the .MTM LLE command. 

6.4 LOAD-LEVELING OPTIMIZING AND CONTROL (.MTM LLE) COMMANDS 

The commands used by the system administrator to optimize and 
control operation of the LLE are: 

e@ .MTM LLE CPU 

e .MTM LLE DISPLAY 

e .MTM LLE ELIGIBILITY 

@e .MTM LLE LPU 

e .MTM LLE OFF 

e .MTM LLE ON 

The commands used by the system administrator to control the PSM 
are: 

e@ .MTM PSM 

e ..MTM PSM INTERVAL 

e .MTM PSM I/O 


@ .MTM PSM MAXPROCESSOR 
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6.4. 


The 
LILE . 


1 


.MTM LLE Command 


.MTM LLE command enables the system operator to control the 


Format: 


-MTM LLE 


Parameters: 


LPU 


CPU 


DISPLAY 


OFF 


ON 


n,F 
ELIGIBILITY| < tf 
,N 


When LLE is active, this command will cause 
MIM to place all of its subtasks (which are 
able to run on an APU) on queue OO (LPU 0O 
directed). When LLE is not active, this 
command will be rejected and the MTM- subtasks 
will be placed on the CPU ready queue. 


When LLE is active, this command will cause 
MIM to place all of its subtasks on the CPU 
ready queue. 


This command displays current variable/fixed 
threshold values, PSM values, CPU and APU 
loads and queue information to the _ system 
console. 


This command removes the LLE from the’ system; 
all future starts of MTM subtasks will be on 
the CPU ready queue. 


This commangd will load and start the LLE 


(taskid = .MTMLLE). Eligibility is set to its 
default which is 1%. 
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ELIGIBILITY This command controls the eligibility value 
and/or the evaluation logic. 


n is the fixed queue 0 eligibility value in 
percent. The range of n is between 1 and 
99. If n is omitted, the previously 
specified value is used. The default 
after LLE start is 1%. 


E is the fixed queue 0 eligibility mode for 
the LLE. 
D is the dynamic queve 0 eligibility mode 


for the LLE. 


N is the nooperation mode for the LLE. 


Functional Details: 


The .MTM LLE commands require that MTM is sysgened with the PSM 
(see Section 2.4.21). 


WARNING 


THE LLE DOES NOT CONTROL ALL OF THE TASKS 
CAPABLE OF EXECUTING ON APU QUEUE 0. 
SPECIFICALLY, IT DOES NOT CONTROL MTM 
SUBTASKS WITH THE SVC6 CONTROL PRIVILEGE 
NOR TASKS LOADED FROM THE OPERATOR 
CONSOLE. THIS MAY LEAD TO MONOPOLIZATION 
OF QUEUE 0 BY THE UNCONTROLLED TASKS AND 
CONSEQUENTLY DEGRADE THE PERFORMANCE OF 
THE CONTROLLED TASKS. 


After the .MTM LLE OFF command is entered, MTM subtasks which are 
On queue 0 are transferred back to the CPU ready queue. 


After the .MTM LLE ON command is entered, MTM checks that the PSM 
was enabled at MTM sysgen. If the PSM was not enabled, this 
command is rejected. If the PSM was enabled, MTM issues an SVC13 
to set queue 0 to enforced priority order and loads the LLE. MTM 
then checks the LLE revision level to ensure that the proper 
' terminal user (TUB) structure is used. If the structures do not 
Match, an error message is output to the system console to inform 
the user that LLE has been cancelled. 


The .MTM LLE ELIGIBILITY command, when set to the fixed mode, 
enables the system operator to establish a fixed queue 0 
eligibility level. The range of n is between 1 and 99, which 
indicates the fixed queue 0 eligibility value. This value sets 
the fixed queue 0 eligibility value for the LLE and is used _ to 
determine if a task is to be placed on either queue 0 or the CPU 
ready queue. 
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When the .MTM LLE ELIGIBILITY command is set to the dynamic mode, 
LLE switches to the variable threshold evaluation (see Section 
6.2.3). 


When the .MTM LLE ELIGIBILITY command is set to the 
nonoperational mode, the LLE operates according to the previously 
set mode except no actual task redirection between the CPU and 


queue 0, based on the eligibility/threshold evaluation, takes 
place. 


Examples: 


This example causes MTM subt:asks under LLE control to be placed 
on queue 0; 


-MTM LLE LPU 
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The .MTM LLE DISPLAY command outputs the following information to 
the system console: 


14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 
14: 


56 
56 


56 


56 


56: 
245 


56 


56: 
2:45 


56 


56: 
56: 
56: 


245 
245 
56: 
56: 
56: 
245 
56: 
56: 
56: 
56: 
245 


45 
45 
45 


45 
45 
45 
45 


45 
45 
45 


45 
45 


or 
or 


:PSM: INTERVAL= 4 I/O= 335 


:LLE MODE=DYNAMIC 
:LLE MODE=FIXED 
:LLE MODE=NOOPERATION 


MAXPROCESSOR=25 $% 


ELIGIBLE= 1.0 % 
ELIGIBLE= 0.0 3° 


> LOAD: LAST 4 SEC LAST 40 SEC SINCE START 
: CPU 18.8 % 4.5 % 6.8 % 
APUL 0.0 % 0.0 % 0.0 % 


:MTM: SUBTASK INFORMATION 


LPU 0 DIRECTED 0 
CPU DIRECTED 4 
CPU READY QUEUE 0 
CPU REC. QUEUE 0 
QUEUE 0 4 
EXEC/WAIT/ROLLED 0 


This example removes LLE from the system: 


-MTM LLE OFF 


The following example loads the 


system volume: 


-MTM LLE ON 


TASKS 
TASKS 
TASKS 
TASKS 
TASKS 
TASKS 


MTMLLE.TSK/S from the default 


Table 6-1 lists the error messages output by these commands. 
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TABLE 6-1 LLE ERROR MESSAGES 


ERROR MESSAGE | AFFECTED COMMANDS | MEANING ] 
So Same sete ese meee eee RSS EER SERB e SESE H ESSE ea BESTE ESS SSeS ss SSS SSE ses === | 
ERROR: NO PSM OR | .MTM LLE CPU | The entered command is rejected | 
NON MPS 3200 SYSTEM | .MTM LLE DISPLAY | because PSM was not sysgened or | 
| .MTM LLE ELIGIBILITY | the command was entered on a | 
| .MTM LLE LPU | system other than a Model 3200MPS. | 
| .MMT LLE OFF | | 
| .MTM LLE ON | | 
So SSS SSeS SSS | penne nen nn nan | orn e terre wn nner nner erent arena ren=== | 
ERROR: LLE | .MTM LLE CPU | The command is rejected because | 
STATUS=OFF | .MTM LLE ELIGIBILITY | the LLE task is in the inactive | 
| .MTM LLE LPU | state. | 
| .MTM LLE DISPLAY | | 
| .MTM LLE OFF | | 
Sas anise ee cia msi ctae cal aml) a aa) (aaa gli ccna | 
INVALID | .MTM LLE | Parameter used with this command | 
Parameter | | was misspelled. 
Ee pe De en elt Ye NO ON PE PE eNO eA PE an AH ARE ec CP Be Op Ome i Re ger oe | 
Missing | .MTM LLE | Command was entered without an | 
operand | .MTM LLE ELIGIBILITY | operand | 
(ce ae ct cam me se cy me Dam mm em th es me is es et cS Me come mf > > SEY et cy SS OD ee SAD EY SUD me ORD GD SE mh ms OS GON fit cy OE sa me ae ee Sate es nit te Oe ee a ee ae es to | 
ERROR: FILE | .MTM LLE ON | The command is rejected because | 
DESCRIPTOR | | .MTM cannot load the LLE task due | 
ERROR | |} to an fd error. | 
ERROR: LLE {| .MTM LLE ON |] The command is ignored because an | 
STATUS=ON | | attempt was made to start the LLE | 
| |] task when the task is already | 
| | active. | 
et a Se ac a ci eh a aan eee ie ar als | 
ERROR: LLE | .MTM LLE CPU | The command cannot be performed; | 
STATUS=yyyy AT | .MTM LLE DISPLAY | the LLE may be in one of the | 
erradd/LLE. SAD | .MTM LLE ELIGIBILITY | following error states where yyyy | 
AT segadd | .MTM LLE LPU | is replaced by: 
| .MTM LLE ON |] 2??? = undefined (paused, | 
| | looping, etc.) or task | 
| | queue (##LLE) overflow, | 
| | because LLE couldn't get | 
| | CPU/APU time to perform | 
| | an LLE run. LLE must | 
| | have the highest priority. | 
| | No other task or command | 
| | Processor should have the | 
| | same priority. | 
| | NAPU = no APUs assigned to queue | 

| | 0 
| | ILGF = internal logic fault | 
| | ARFT = arithmetic fault { 
| | PWFT = power fail trap | 
| | DFFT = data format fault | 
| | IINS = illegal instruction | 
| | MMAL = machine malfunction | 
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TABLE 6-1 LLE ERROR MESSAGES (Continued) 


| ERROR MESSAGE | AFFECTED COMMANDS | MEANING 


| errad = the absolute address 

| where the error occurred. 

| segadd = the absolute address 

| where .MTM LLE UDL 

| Starts. To recover from 

| those errors, use the .MTM 
| LLE OFF command, then the 
| -MTM LLE ON command. 


ee ee ee at Oe Me ee YS ce ee Ge ee ee Ee EE ees Oe Se OS Ge Sr Om eee ee ee mre ne See GES GT ST Gee See OE ee Oe Om ne SES SET Cee Se me re ee et eae ee ee ae es et ee eee ee ee ee ee ee ee Oe ee 


LOAD OR | .MTM LLE ON | Indicates that the load of the LLE | 
START ERROR, | | returned an error status for the | 
SVC6, STATUS= | | SVC6. yyyy is the hex status | 
X'yyyy' | | returned by the SVC6 handler. A | 

| | gggg as status means that MTM | 

| | couldn't find the .MTMLLE TCB. | 
ERROR: voln: | .MTM LLE ON | Indicates that the MTMLLE.TSK/S on | 
MTMLLE. TSK/S | the default system volume (voln:) | 
ASSIGN ERROR | | could not be assigned to .MTM. | 


ce re eee ee cree ee nee ee re ere ee re ee ee ee re ere cree cre eee cee eee ee ee ey me re cee ree ee eee ee ee ee ee ee eee cet ee ee Oe ee ee ce ee ee eee ee ee ee 


ERROR: voln: 
MTMLLE. TSK/S 


| | Indicates that the MTMLLE.TSK.S on | 
| | the default system volume (voln:) | 
HAS WRONG | | has a different revision than the | 
REVISION LEVEL | | .MTM task currently executing. | 


ee eS oe es Ge SD ee ee ee ge ee ee ee ee ee ee ee ee Oe ee ee re re ae ee ee ce ee ee em ee es ae re ee ce ee re ee ee re ee ee en ee ee ee ee ee ee ee ee ee ee ee ee ee 


ee ST 


6.5 LOAD-LEVELING EXECUTIVE (LLE) OPERATING TIPS 


Before turning LLE on, the operator should ensure that PSM has 
been sysgened into the system. See Chapter 2 for information on 
the MTM sysgen option. LLE overrides LPU task assignment 
supplied via MTM or Link; therefore, the operator’ should 
broadcast a message to all MTM users that automatic load leveling 
is in effect. The user must have APU and SVC6 control privileges 
to be able to access LPU numbers other than 0. If the MTM 
terminal user wishes to run a task on an APU that is not assigned 
to queue 0, that task can be run from the system console. 
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6.4. 


2 .MTM PSM Command 


This command enables the system operator to control the PSM. 


Format: 


INTERNAL n, 


-MTM PSM< 1/0 no 


MAXPROCESSOR n3 


Parameters: 


PSM 


INTERVAL 


ny 


1/0 


No 


MAXPROCESSOR 


Ng 


indicates that this command is directed to the 
PSM handler within .MTM. If no Further 
parameter is specified, the current PSM values 
are displayed on the system console. 


selects the interval value for change. 


is the time interval in seconds between the 
PSM pricrity recomputing cycles. The range 
for n is 1 through 10. 


selects the I/O count for change. 


sets the maximum number of I/O (performed in 
the last PSM interval) that are used to 
recompute the new priority for an MTM subtask. 
the range for n is 1 through 9,999. 


selects the MAXPROCESSOR value for change. 


is used as a percent value in PSM to determine 
the MTM subtask priority. If an MTM subtask 
uses more than this value of processor time 
(in the last PSM interval), it's priority is 
reset to the lowest PSM priority. 
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Functional Details: 

The new PSM values are displayed after each command to the system 
console. The defaults set up at the start of MTM are as follows: 
Interval n = 4 sec / I[/O n = 500 / MAXPROCESSOR n = 25 $% 

Example: 


This example selects an I/O count of 335 and the _ following 
information is returned: 


-MTM PSM [I/O 335 
10:02:20 -MTM: CURRENT PSM: INTERVAL=04 SEC IT /0=0335 MAXPROCESSOR=25 % 


Table 6-2 lists the error messages output by these commands. 
TABLE 6-2 PSM ERROR MESSAGES 


MEAN [NG 


ERROR MESSAGE |} AFFECTED COMMANDS 
INVALID ij -MTM PSM INTERVAL The given parameter n 


I 
1 
t 
-MTM PSM I[/0 | is invalid. Check 

t 

t 

f and correct accord- 
t 

{ 


} 

i 

H H 
| PARAMETER 
H ! .MTM PSM MAXPROCESSOR the value specified ' 
1 i] 1 
! ! ! 
t | 


ingly. 

See ree ity SP ea een See fee eg ag eae TR, Oa Ney ge eT IN ey gre ag RT ag ae Re eT Penne ee ad eae ek { 
} PSM NOT } .MTM PSM | The entered command H 
| SYSGENED | -MTM PSM INTERVAL | is rejected because 
| -MTM PSM [/0 | the PSM was not sys- | 
H i -MTM PSM MAXPROCESSOR | tem generated (sys- 
i gened). 
er ratebatatehateteratateacanetataretaneiatapsnemensteienstedubaiamananatemmanaenemmmareanemanaestartamanate 
' MISSING } .MTM PSM INTERVAL | The entered command H 
| OPERAND | -MTM PSM I/O | has a missing oper- 
H } .MTM PSM MAXPROCESSOR } and. Reenter the H 
\ H | command specifying a_ | 
H H i value for n. H 
A sce Sac sacra ob “snin Sec Cah» ie a ek iii sds tsb Gt tu aks Ta ac econ sas ca > es ie sas aa Nines ‘ae. adi: waa ae eg ae ech a a aR ere a tae ' 

EXTRANEOUS -MTM PSM . The entered command 

OPERAND -MTM PSM INTERVAL has an extraneous 


-MTM PSM MAXPROCESSOR command omitting the 
extraneous operand. 


Le ee A Se RS LR NE SR A SS GE REN ROD RENO cy SS REND Lem ED NAD NS Am RSE Oey MOPS SR ED LO ee WE RS OD ROD ed Une me A SD ED ED ED SES OR EE EE BD So ee ee OS OD ee ee ae eee et 


t 
| | 
| 
| -«MTM PSM I/O } operand. Reenter the } 
i ' i 
! ! ! 
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et amen awe ames eee eee ewe ee es ee ee ee ee ee wee ee ee 


6.5 LOAD-LEVELING EXECUTIVE (LLE) OPERATING TIPS 


Before turning LLE on, the operator should ensure that PSM has 
been sysgened into the system. See Chapter 2 for information on 
the MTM sysgen option. LLE overrides LPU task assignment 
supplied via MTM or Link; therefore, the operator’ should 
broadcast a message to all MTM users that automatic load leveling 
is in effect. The user must have APU and SVC6 control privileges 
to be able to access LPU numbers other than 0. If the MTM 
terminal user wishes to run a task on an APU that is not assigned 
to queue O, that task can be run from the system console. 
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APPENDIX A 
MULTI-TERMINAL MONITOR (MTM) 
SYSTEM GENERATION (SYSGEN) OPTIONS 


OPTIONS: 
CDBUFSIZ EQU n Size of sector buffers 
CONBFSZ EQU n Size of console buffers 
CSBFSZ EQU n Size of ‘command buffers 
NCONBFS EQU n Number of console buffers 
NCSBFS EQU n Number of extra command buffers 
NCSSLVS EQU n Number of command substitution 

system (CSS) levels 
NMSGS EQU n Number of message buffers 
NSECTS EQU n Number of sector buffers 
NUSERS EQU n Number of concurrent users 
PRCLIMIT EQU n Processor time limit 
QUESIZE EQU n Size of task queue 
SGN.ACT EQU n Roceaeans support/number of classes 
SGN.ASST EQU n ‘Number of MTMASST tasks 

0 

SGN.BTCP EQU Batch job pause 


1 
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SGN.MVOL EQU C'name' Default user volume 


SGN.PRIO EQU n Batch priority 
SGN.SCHR EQU n Subtask scheduling 
0 
SGN .ROLL B00} Tasks rollable 
SGN.SPL EQU n SPL/32 support/number of buffers 
SGN.VAR EQU n Numbers of variables. 
SGN.@GLO EQU n Number of new global variables 
SGN.@INT EQU n Number of internal variables 
8) 
SGN. $HSP cou}. | HASFP interface 
MACROS : 


IOTAB - I/O class number, identification, Limit: 


[label] IOTAB (classno,classid [, iocount]), 


(classno,classid [, iocount]), 
PRMTDEV - device to which prompt sequence applies: 


label] PRMTDEV a es 
Label] ? Ge ae L - ae) n| 


[label] PRMTDEV (SIGMA,dev, [,...,devn]) 
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PRMTSEQ - prompt sequence; command, task, build: 
[label] PRMTSEQ (SIGMA) 


[label] PRMTSEQ (pname;, ,(com-req,x),(task-exec,x), 
: (task-read,x), (build-read,x) ), 


peeeor 
pname ,(com-req,x), (task-exec,x), 
(task-read,x), (build-read,x) )y] 


Gabel] PRMTSEQ (STANDARD, (com-req,x),(task-exec,x), 
(task-read,x), (build-read,x), 


UIOLIM - I/O limits, all I/O classes per user class: 


label] UIOLIM (ugidogt,-.-,Uoiogt) , (Ugiogb, .--,Ugionb) 


(uniont, ...,uniont), (uniogb,...,Unionb) 
UPRCLIM - processor time limits for I/O classes: 
[label] UPRCLIM limitot,limitob,...,...,limityt,limitpb 
VERSION - MTM parameter file identification: 


[label] VERSION '‘id' 
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APPENDIX B 


AUTHORIZED USER UTILITY COMMANDS 


ACCOUNTS n 


signont ime 
ADD actno,groupno, password, fuser id] ’ 3 


x 
([-privi leges]} 


CHANGE actno, [groupno], [password], [user id] | 


processortime 
R [privileges] 


DELETE act.no 
END 


LIST [actno, [, actnog] | 


CREATE 
MODE UPDATE [= fa 3] 


REPORT 


PAUSE 


privileges 
PRIVILEGE | actno, [; actnog] : 


x 
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processort ime 
x 


signont ime 
: 


CREA 


COMMAND 
START, =fd, ,LIST=fd, ,( UPDATE) =fd, [, ACCOUNTS=n] 
i CMD , 
REPORT 
TOTAL [C ] 
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APPENDIX C 
AUTHORIZED USER UTILITY MESSAGE SUMMARY 


taskid > for CON: 
or 
---> under MTM 


is the prompt, generated for an interactive device, 
indicating an input request. . 


ACTUTILITY rr-uu 


identifies the Account Utility. The revision level is rr; 
the update level is uu. This message is output only at the 
initial start of the Account Utility. 


ACCOUNT UTILITY RUN xx/xx/xx yy:yy:yy 


appears on the system console when the Account Utility is 
started. It informs the operator that the Account Utility 
has been run. 


***XSET DATE & TIME 


is the date request that pauses the Account Utility so the 
current date and time can be set for the system. The system 
CONTINUE command transfers control back to the Account 
Utility. This message is output when the date and time are 
not set. 


**xXACCOUNT NUMBER xxx WAS INACTIVE 
indicates the requested command could not be performed 


because the indicated account record was inactive. The 
indicated account number is xxx. 
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** xXACCOUNT NUMBER xxx WAS ACTIVE 
indicates the requested command could not be _ performed 
because the indicated account record was already active. The 
indicated account number is xxx. 


ACCOUNTS=n 


indicates the maximum account number on the current AUF. 


***xXxXxxXxXxX IS THE CURRENT MODE 


indicates the output from the MODE command. The name of the 
current mode (CREATE, UPDATE or REPORT) is xxxxxx. 


is the question mark, along with some of the following 
messages, used to denote which parameter in the command 


caused the error. The command and a pointer (?) to the 
location of the error is displayed to the command input 
device. 


x**xxTLLEGAL INPUT COMMAND 


indicates the command word or abbreviation could not be found 
in the table of legal commands. 


***XWRONG MODE FOR INPUT COMMAND 


indicates the current mode does not allow the input command. 


*** ILLEGAL COMMAND FORM 


indicates the input command uses too many separators or a 
separator other than a comma or equal character. 


xx* ILLEGAL PARAMETER 


indicates the input command is missing a required parameter 
or has too many parameters. 


***TLLEGAL START PARAMETER 


indicates a START command word or abbreviation was not found 
in the START command table. 
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***xDUPLICATE START PARAMETER 


indicates the START command contains a duplicate command word 
or more than one mode request. — 


***x ILLEGAL FILE DESCRIPTOR 


indicates the file descriptor (fd) used is syntactically 
incorrect. 


**XxXMISSING START PARAMETER 


indicates at least one START parameter is missing from the 
specified mode. 


* x xATLOCATION/ASSIGNMENT ERROR 


indicates a file cannot be allocated because of a filename 
conflict or the filename specified for the assignment could 
not be found on the specified disk. 


*x*]lu xx NOT ASSIGNED 


indicates a requested function could not be performed because 
the logical unit (lu) xx was not assigned. The utility is 
paused and control transfers to the system. The system 
CONTINUE command continues the utility after the assignment. 


*x* INPUT DEVICE ERROR xx on LOGICAL UNIT yy 


indicates an input request has an input/output (1/0) error on 
device xx assigned to lu yy. The Authorized User Utility 
pauses. The system CONTINUE command transfers control back 
to the utility. 


***OQUTPUT DEVICE ERROR xx ON LOGICAL UNIT yy 


indicates an output request has the I/O error on device xx 
assigned to lu yy. The Authorized User Utility pauses. The 
system CONTINUE command transfers control back to the 
utility. 


***MISSING PARAMETER 
indicates the input command is missing a required parameter. 
On input errors, where the form of the command or its 


characters are incorrect, the command anda pointer (7) to 
the location of the error is displayed to the user console. 
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***xXMODE NOT ALLOWED 


indicates an attempt to perform an UPDATE or a REPORT was 
made from an account other than 255. 


***WARNING ACCOUNT 255 DOES NOT EXIST 


indicates an attempt to end the Account Utility when 9 account 
255 does not exist. 
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APPENDIX D 
ACCOUNTING TRANSACTION FILE (ATF) RECORD FORMATS 


The data structure of the ATF is defined by the $ATF data 
structure macro contained in SYSSTRUC.MLB. The fields and 
functional values in the ATF account records’ have standard 
symbolic names. These names may be accessed by coding and 
expanding the $ATF data structure macro (see the Common Assembly 
Language Macro/32 Processor (CAL Macro/32) and Macro Library 
Utility Reference Manual). Each of the six ATF account record 
types is associated with a particular type of account activity. 
‘The record length of an ATF record varies with the number of 
input/output (1/0) classes supported by the system. The record 
formats shown in this appendix are 128 bytes and accept entries 
for the four default 1/0 classes. The record types are listed in 
Table D-1l. 


TABLE D-1 ATF RECORD 
TYPES 


1 Signon 
| 2 | Signoff | 
| 3 | Task completion | 
| 4 | Task data overflow | 
| 5 | File deletion | 
| 6 | File renaming ! 


ee me ee eee ee mee cee ee cee ee eee mene eee es mee tem mee ee ee me me 


These six record formats are illustrated in the _ following 
figures. 
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ee ee em cee ee ee rm ee ee es me ee ee ee ee ee ee ee es es ee ee es ee ee ee ces ee ee ee ee ce ee ee ee ee ee ee ee ee ee 


10(0) Record Type 12(2) Account Number H 
(ATF .TYPE) H (ATF .ACCT) 
Tai ctepiie calarerae Rania eRe Rae | 
14(4) Current date and time i 
1 (ATF .CRTM) | 
lpaeteigsaieies sir mesic cia a oe cl ace rina niet ee ea | 
i8(8) 
[eeaee= User identification Sree 
{12(C) (ATF .UID) 
[oS ee ee ee Sera ete ae ee sae 
116(10) Job serial number 
(ATF . JOB) 
lice lune g cieriaia ciaiciniciaialnicie rs itera ahearaans ears aaa ge al a | 
i 20(14) 
ee ae | 
1}24(18) 
Saami asi File descriptor (fd) of oS 
128(1C) command input file i 
SSS e= CATF;.UPD), ££ 2 est cae 
132(20) 
[ee EE ES 
1}36(24) 
lela mia ASL ene EER GR Sa 
}40(28) Date and time job was submitted 
to batch queue (ATF.SUBT) 
[ee ae eS re ge er ee ge ge eg ee 
{44(2C) 
amas me Patter  ——— =eaietene 
148(30) 
a a aa ae mr 
eS ned ee Se ee a a Re aC en RN Cea ES CEE eye Or ee 
' i 
1116(74) 
Poaeeae aes 
1120(78) Filler 
pre ——“ CRS OS 
}124(7C) 


Cee tianee ieee Mee Nie Eine I ee ee ee 


Figure D-l ATF Format for Signon Account Record Type 
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ee ee ee a EF SS DS ES GD mY ct SS eS MA ND GN GEES CED ONES GED GED OE? GR GE GS mes GD ae GP eee et ee ee Oe ee Gee SUD SED See eee ee OE ee mee new am cum ee 


{0(0) Record type }2(2) Account Number ' 
i (ATF .TYPE) } (ATF .ACCT) | 
[PRR ARS Hae Sere ORS aS SS Ree ae SSeS See eee SS ees i 
14(4) Current date and’ time 
(ATF .CRTM) 1 
a am aca a a a aaa aa a ce aaa a el 
18(8) 
ice taincis User identification = = — ==---- 
}12(C) (ATF .UID) 1 
Se Set aE ae ee ie a ae ee ie ee ee 
}16(10) Job serial number 
H (ATF .JOB) 
He ae TT age IN Fe ea ee rr ry ee ee a eee rem pe es) ae 
120(14) Number of tasks }22(16) Number of CSS exit 1 
H run (ATF .TASK) { (ATF .CSS) } 
LaPeer a a See eae eS eer eee aS eer Sea ae eae 
'24(18) Number of commands /|26(1A) Number of aiepiay H 
{ entered (ATF.CMDS) | files (ATF .DISF) | 
cm ea ad a a a 
ett) Elapsed time (ATF .ELPS) 
(Sees Sea ees ae SS a eS a ee ee er a 
|32 (20) 
pa See PET ey 00a 
}36(24) ' 
ea a a 
ae ee ea a nee a ne Yee pee eee nee ees eee ee a 
'116(74) 
Pe REE 
'120(78) Filler i 
pire 
reer S) 
Figure D-2 ATF Format for Signoff Account Record Type 
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+12(C) (ATF .UID) H 
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}20(14) Time task was started (ATF. aTAR) i 
LB SSeS A ae Se Re a Be ee eee ia ie ae ee H 
1 24(18) H 
fe HRS SS i 
128(1C) 
rhe ate: fd of task SSeS { 
neetet) (ATF .TFD) } 
Pe EES H 
1 36(24) 
Loe Te See SPOS DSSS S SSeS STS SRS se Ree eae eee eae See { 
140(28) Account number 142(2A) End of task code H 
H (ATF .ACT) ' Biel RC) H 
PRT ees ASS eS SSR SSeS See rR SSS ar SSeS eS Sa SSS SSS seer Sse H 
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acetate User-supplied information ae aa aa 
(48(30) (ATF .USER) i 
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(52(34) Impure segment 154(36) Pure segment size ' 
: sure (ATF.IMP) } (ATF . PUR) 

he SSSR SSS aS SSS See SSeS SS Se SSeS See scSee nce tees ss H 
'56(38) System space {58(3A) Roll count i 
H (ATF .SYS) H (ATF. BOLE) H 
LOS aS SSS Sa SS eS Stes Rare Rees Re SSS eer as 1 
160(3C) User CPU time (ATF .UCPU) i 
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'64(40) SVC CPU time (ATF.SCPU) ! 
Poe Se Se SSP STS eS SS SSeS SSS Se Se SSC See eet eS i 
168(44) ROLL CPU time (ATF. RCPU) | 
Ua RSs TAS ae SR Se ESS SSS SSS er Se ees ae SS see Seo H 
172(48) User APU time (ATF .UAPU) H 
Pon a a Se ee See SSR Sete at SSS eS eS Se Sse SSeS ee { 
176(4C) Wait time (ATF.WTIM) i 
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1,80(50) Roll queue time (ATF.RLTM) H 


184(54) Input /output (1/0) count for class O (ATF.IOCT) } 
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1 88(58) Number of bytes eeanet etre for class 0 
' (ATF . LOXF ) 
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196(60) Number of bytes tranaferred for class 1 7 
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:120(70) Filler — 3 
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aes ee Ree SS ee ee ee aS ee Sear e Sea eae ae 
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oa S = New filename 0 == ==== 
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: splasc ci Sal cas muy misd sence) aed aim a pesca ats ope Carnage tease mss Veit Sgt Ns es “etn Cafu so ea sap Nn amy nn spa Gla nd "Susie pc Gemini ee” S  ie a  an ae e Sg a 
156(38) ID of task a 
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+16(10) Message pointer for SVC6 
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i a i am i’ SS ee tt la et p< sweet ee ema tps a's ‘woke’ wt’ aa’ iv ec eck cms ete tna” ets Ses meow) ea mi nn 7 ew Vics mi ein) esata ae H 
120(14) © Filename (abeand word) H 
{ (ATF .FNM2) H 
1 ec a eae an eee se Vn emi ~e (acenk  cnn ein cySe  a d mcene fees me Yuse“mlc fee Ve Sem em a ale oem ens fops Tae es { 
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28(1C) Number of records 
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i 
132(20) Number of sectors 
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(ATE.SECS) 
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36(24) . File creation date H 
(ATF .CDAT) 
sat ot acs hata i ses ria LL deg cinta las Ses Soca amet el ey ence eens at oa Dy me ee ta, Sal tes cl ve Beal echidna a ee | 
40(28) H 
eRe Medea lied poeta etl 
144(2C) 
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156(38) ID of task H 
joctcto that deleted file 7 — wren = ' 
160(3C) (ATF .TKID) 1 
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Figure D-5 ATF Format for File Deletion Account Record Type 
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APPENDIX E 
MULTI-TERMINAL MONITOR (MTM) OPERATOR COMMAND SUMMARY 


LOAD .MTM,fd 
TASK .MTM 


START ,AUF=-fa [aTF=fd] |,TERMINAL-(fd, [fd2,... faz) | 


[BaTcH=(n,£d) |, PACE=fa ] 


WAIT 
TERMINAL 
STATUS 
USED [,fdi]_ 
TELL 
userid message 
MESSAGE 


BROADCAST message 
device: 
.MTM ADD 
BATCH n[,fa] 
TERMINATE device: 
device: 
REMOVE 
BATCH n 
QUIESCE 
PURGE fd 
INQUIRE (fa ] 
SUBMIT fa 
ATF fd 
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INTERVAL n, 


PSM |4 I/O np, 


-MTM LLE 


MAXPROCESSOR ng 


n,]F 
ELIGIBILITY) ,D 

N 

v 
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Account 
limit 
number 


Accounting data 
batch job 
task-related 
terminal session 
terminal user access 
Accounting Facility 
system requirements 
Accounting times and formats 
elapsed 
processor 
processor time left 
roll CPU 
signoff 
signon 
SVC CPU 
task elapsed 
total processor 
total task elapsed 
user APU 
user CPU 
Accounting transaction 
files. See ATF. 
ACCOUNTS command 
ADD command 
ADD parameter 
Assistant task 
ATF 
~MTM command 
parameter 
AUF 
building and starting 
CREATE mode 
parameter 
REPORT mode 
START command 
UPDATE mode 
Authorized user file. 
AUF. 
Authorized User Utility 
Authorized User Utility 
commands 
ACCOUNTS 
ADD 


See 


CHANGE 


DELETE 
END 

LIST 

MODE 
PAUSE 
PRIVILEGE 
TOTAL 
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3. eee WwW 
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i 
be 
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BATCH parameter 

~MTM ADD 

~MTM REMOVE 

MTM START command 
Batch processing 

PRC limit 
BROADCAST parameter 


C 


CDBUFSIZ option 
CDS 

CHANGE command 
Command buffers 


Command substitution system. 
See CSS. 
CONBFSZ option 
Concurrent users 
per accounting user class 
Configuration 
MTM 
Console buffers 


Control/Diagnostic system. 
See CDS. 

Count of I/O transfers 

CREATE mode 


CSBFSZ option 

CSS 
generating MTM 
levels 


Data 
collection 


structures 
Date and time submitted 
Date formats 
Default volume 
DELETE command 
Dynamic scheduling 


Elapsed time 
END command 
End of task code 


Error 
messages 
termination 


+t ttt 
> 


NWN SP PD LP 
! 
NORPNMNWHAWWH 


& hb © 
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F 
Facility, Accounting 


Fds 

task loaded 
File descriptors. 
Forced roll 


See fds. 


G 


Global variables 
new global 
new internal 


H 


HASP interface 


1/0 | 

class table 

control block 
Input/output. See I/O. 
INQUIRE parameter 
Internal variables 


IOTAB macro 


Job number 


L 


Link OPTION command 

LINKOPT option 

LIST command 

LLE 
-MTM LLE command 
APU task queue assignment 
control of MTM subtasks 
dynamic mode of operation 
error messages 


error termination 
fixed mode of operation 
operation 


optimization and control 
queue 0 eligibility 
Load-leveling executive. 
See LLE. 
Loader storage unit. See 
LSU. 
Local variables 


Logical unit. See lu. 
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aw 


!rpditttrtttit bts 
_ i) Nn 


a ee oe WD 
NPY NW PP ATW ERS OW 


LSU 
Lu 
M 
Memory 
requirements 


used by a task 
Message buffers 
MESSAGE parameter 
MODE command 
MTM 
configuration 
data structures 
description 
establishing accounts 
link 
operating procedures 
operation in a Model 
3200MPS System 
sysgen 
MTM command 
format 
~MTM command 
examples 
parameters 
-MTM LLE commands 
CPU 
DISPLAY 


ELIGIBILITY 


examples 
LPU 
OFF 


ON 


PSM 

-MTM LLE ELIGIBILITY 
dynamic queue 0 
fixed queue 0 
nooperation mode 

~MTM PSM commands 
example 
I/O 
INTERVAL 
MAXPROCESSOR 

MTM START command 

MTM sysgen options 
batch job pause 
batch job PRC limit 
batch job priority 
command buffer size 
command buffers 
concurrent users 
console buffer size 
console buffers 
CSS levels 
default user volume 
forced roll 
global and local 
variables 
HASP interface 
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Noe 
on 


ttt ool 
ca wo 


1's t tt pt tt tba fd 
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NNNNNNNNNND VUUOUUUAAA ho ee ae 154) NYO UN We De WW 
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t 
ro AN HAO 


DISPLAY FILES commands 
tasks executed 
NUSERS option 


fixed level 
QUIESCE parameter 


R 
O 
REL 1-2 
Operating procedures Relocating loader. See REL. 
end of task codes 5-12 REMOVE parameter 5-6 
error message 5-13 Renamed and deleted files 4-7 
loading and establishing REPORT mode 3-5 
MTM 5-1 3-7 
MTM START command 5-2 Reporting Utility 4-1 
Operation of the LLE Roll 
computation-intensive count 4-10 
task - time 4-9 


CPU ready queue 
execution of MTM subtasks 
queue 0 
service-intensive task 
Optimization and control of 
load-leveling 
OS/32 Accounting Facility. 


MTM sysgen options | P 
(Continued) | 
I/O class table 2-8 | PAGE parameter 5-3 
I/O count limit per user | PAUSE command 3-20 
class 2-29 | PRC time 4-8 
message buffers 2-14 | PRCLIMIT option 
MTM link 2-9 | batch job 2-16 
new global variables 2-28 | I/O count limits 2-29 
new internal variables 2-28 =| job pause 2-20 
number of MTMASST tasks 2-l4a | per user class 2-32 
OS/32 Accounting Facility . 2-19 | relative default priority 2-21 
PRC limit per user class 2-32 | Prevention of CPU overload 6-3 
prompt device 2-17 | Priority scheduling 
prompt sequence 2-17 «| dynamic 2-23 
scheduling 2-23 | Priority scheduling 
sector buffer size 2-6 | mechanism. See PSM. 
sector length buffers 2-15 | PRIVILEGE command 3-20 
SPL/32 interface 2-27 | Privileges 
task queue size 2-19 | account 3-21 
version identification 2-33 =| account 255 3-11 
MTMMAIN module 2-1 | default 3-11 
~MTMMASST TASK parameter file 5-3 | PRMTDEV macro 2-17 
MTMPARMS.MAC parameter file 2-2 | PRMTSEQ macro 2-17 
MTMSGN.CSS command file 2-4 | Processor time limit 3-3 
MTMSTRUC.MLB macro library 2-4 | per account 3-4 
Multi-terminal monitor. See | Program development feature 2-13 
MTM. | Prompt 
Multiprocessing environment 6-1 | device 2-17 
| sequences 2-17 
| PSM 2-23 
N | 6-1 
| interval 6-3 
NCONBFS option 2-10 | PURGE parameter 5-7 
NCSBFS option 2-12 =| 
NCSSLVS option 2-14 | 
NMSGS option 2-14 =| Q 
NSECTS option | 
Number of | QUESIZE 
commands entered | Queue 0 eligibility 
CSS calls executed ! algorithm 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


48-023 FO1 RO3 
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Secondary directory 
Sector buffer 
SGN.SHSP option 
SGN. @GLO option 
SGN. @INT option 
SGN.ACT option 


SGN.BTCP option 2-20 | User identifier 4-7 
SGN.MVOL option ~ 2-20 | 4-9 
SGN. PRIO option 2-21 {| User-supplied information 4-11 
SGN.ROLL option 2-23 | Utility 
SGN.SPL option 2-27 | Authorized User 3-1 
SGN.VAR option 2-27 | 3-5 
Signoff | Reporting 4-1] 
date and time 4-6 | 
time 4-12 | 
Signon | V 
date and time 4-6 | 
per account 3-4 | Variables 
time limit 3-3 | global 2-27 
SPL/32 interface 2-27 =| local 2-27 
new 2-28 | VERSION macro 2-33 
START command | 
Authorized User Utility 3-5 | 
MTM 5-2 | W,X,Y,Z 
STATUS parameter 5-5 | 
SUBMIT parameter 5-7 | WAIT parameter 5-5 
Subtask scheduling | Wait time 4-9 
dynamic 2-24 | 
priority 2-24 | 
PSM 2-24 | 
Subtasks of MTM 1-1 | 
Sysgen | 
MTM 2-1 | 
2-5 | 
4-2 | 
OS/32 1-3 | 
1-3 | 
4-2 | 
parameter file 2-2 | 
SYSSTRUC.MLB macro library 2-4 | 
System generation. See | 
sysgen. | 
System requirements 1-2 | 
4-2 | 
| 
| 
? | 
| 
Task | 
counter overflow 4-12 | 
queue 2-19 | 
termination 4-9 | 
4-12 | 
TELL parameter 5=5 | 
TERMINAL parameter §=5 | 
MTM START command 5-2 | 
Terminal prompt | 
device name 2-17 | 
sequence 2-17 =| 
TERMINATE parameter 5-6 | 
Time formats 4-3 | 
TOTAL command 3-26 
| 
U | 
| 
UCLOCK module 1-2 | 
UIOLIM macro 2-29 | 
UPDATE mode 3-5 | 
3-7 | 
UPRCLIM macro 2-32 | 
USED parameter 5-5 | 
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CHAPTERS (Continued) 


MODE Command 
PAUSE Command 
PRIVILEGE Command 
TOTAL Command 


INTRODUCTION 


SYSTEM REQUIREMENTS 

OS/32 System Generation (Sysgen) 
Multi-Terminal Monitor (MTM) System 
Generation (Sysgen) 

Accounting Transaction File (ATF) 


LINK OPTION 
STARTING DATA COLLECTION 


DATA COLLECTION 
Accounting Date and Time Formats 


Terminal Session or Batch Job Accounting Data 


Elapsed Time 

Signon and Signoff Date and Time 

Job Number 

Date and Time a Job is Submitted 

Total Number of Tasks Executed 

Total Number of Command Substitution 
System (CSS) Calls Executed 

Total Number of Commands Entered 

Total Number of DISPLAY FILES Commands 
Entered 

User Identifier (Userid) 

Renamed and Deleted Files 

Account Number 

Task-~Related Accounting Data 

Processor (PRC) Time 

Roll Time 

Wait Time 

Date and Time a Task Started and Terminated 
User Identifier (Userid) 

Memory Used by a Task 

Count of Input/Output (I/O) Transfers to 
I/O Devices 

Roll Count 

File Descriptor (fd) from Which a Task 
Was Loaded 

User-Supplied Information 

Account Number 

Job Number 

End of Task Code 
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